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ABSTRACT 



Managing large software development projects and 
delivering them on time and within budget has proven to be a 
difficult task. The Dynamica Model of Software Project 
Management, has been designed to support the management of 
the software development process. The current interface to 
the model, however, is not suited to the inexperienced user. 

The objective of this thesis is to enhance the usability 
and acceptance of the Dynamica Model of Software Project 
Management. The design of the user interface accomplished in 
this thesis is an attempt to provide the maximum benefit of 
the model to the user by simplifying the process of using, 
viewing, and storing results from the model. This allows 
the user to focus his or her attention on design 
considerations and interpreting model experiments. 

Specifically the accomplishments of this thesis include 
the development of a menu system which provides a logical 
format for accessing the Dynamica model and the creation of a 
Dynex model interface to aid in variable manipulation. 
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I . INTRODUCTION 



A. BACKGROUND 

In recent years, rapid technological advancements in 
computer hardware, and the ensuing cost reduction of 
equipment, has increased the demand for hardware and 
consequently the demand on software. A tenfold increase in 
software demand is expected over the next 1C years [Ref. 
l:pp. 55-62]. 

However, the growth in the software industry has not been 
painless. There are currently numerous problems facing 
software project managers. Software development projects 
have been marked by cost overruns, late deliveries, poor 
reliability and user dissatisfaction [Ref. 2:pp. 36-41] and 

[Ref. 3:pp. 132-142]. Only recently has the software project 

manager seen the development of an assortment of "tools" to 
aid him in estimating, tracking and forecasting costs, 
scheduling completion dates, and in the myriad of other tasks 
which are integral parts of the software development process. 

The Dynamica Model of Software Project Management, 
created by Tarek K. Abdel-Hamid while at the Massachusetts 
Institute of Technology, is one of the exciting new "tools" 
recently developed. It is a comprehensive model of the 
software development process. Written in Professional 
Dynamo, the model integrates both the management-type 



1 



functions (e.g., planning control, and staffing) with the 
software production-type activities (e.g., design, coding, 
reviewing and testing) . 

The Dynamica Model of Software Management can perform 
several important roles. Its main goal is to aid the 
software project manager in understanding the software 
development process. The manager can conduct "what if" 
experiments with the model to develop a more comprehensive 
understanding of the interrelationships of software 
development variables. For example, what is the impact on 
project cost of an increase in quality assurance effort. The 
model allows the user to track, store, graph and plot large 
amounts of project data, quickly and efficiently. In so 
doing, the user can improve and fine tune his fundamental 
understanding of the software development process through the 
advantages gained by using a computer simulation model. 

Secondly, the Dynamica model can be used to aid the 
software project manager in the actual management process. 

For example, the model can be utilized to estimate project 
cost, schedule completion time, and numerous other variables. 
Variables in a software development project can be changed 
and simulations can be run in a matter of minutes. This 
allows the manager to evaluate different management 
strategies . 
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Currently the Dynamica model interface is limited to 
simulations performed by the experienced model user. The 
model does not provide the new user with any assistance or 
guidance. For example, the model does not define the 
variables in the model or explain what options are available 
to the user . 

To provide the maximum benefits from any computer based 
system, great care must be taken in the design of the human 
interface. User friendly systems are much more likely to 
gain wide spread acceptance. Learning to use and operate a 
computer based system must be easy enough for the beginner 
yet flexible enough not to constrain more experienced users. 
The interface of the system, must stress simplicity and 
efficiency without limiting the users creativity. The 
interface should be designed to focus the users attention on 
important information and not clutter the screen with 
inconsequential data. Feedback should be provided in a 
timely manner to keep the users attention. 

B. PURPOSE OF RESEARCH 

The objective of this thesis is to enhance the 
effectiveness of the Dynamica Model of Software Management by 
providing an improved user interface which enhances the 
usefulness of the model for a wide range of users. 

This is accomplished by determining the most commonly 
used functions of the Dynamica model and designing a system 
to allow the user a simple method of access to them. The 
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design of the model interface should build upon and 
complement the menu interface available in Professional 
Dynamo. The interface should be self documenting and lead 
the user through the process of selecting variables, running 
simulations and storing results. It should also allow the 
user to avoid the documentation as his/her experience level 
grows. Since a major purpose of the Dynamica model is to 
enhance the user's understanding of the software development 
process, the interface should ^ rovide the tools the user 
needs for accessing, and analyzing all critical data created 
by the mode 1 . 

C. SCOPE OF RESEARCH 

The scope of this research will include the design and 
development of a user interface for the Dynamica model 
utilizing the executive level interface of Professional 
Dynamo - Dynex, DOS batch files, and the Extended Batch 
Language ( EBL) menu facility EXECMAKE. The model 
documentation included in this thesis will in addition 
comprise a user's manual for the system. 

D. THESIS ORGANIZATION 

Chapter II will briefly discuss problem areas in the 
current methods of software project management and the role 
of the Dynamica Model of Software Project Management to solve 
those problems. The user interface developed in this thesis 
will be thoroughly demonstrated in Chapter III. In Chapter 
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II . RESEARCH BACKGROUND AND OBJECTIVES 



A. CURRENT PROBLEMS IN SOFTWARE PROJECT MANAGEMENT 

There has been tremendous growth in the demand for 
software systems over the past 20 years. The software 
development process unfortunately, has earned an "infamous" 
reputation for cost overruns, late deliveries, poor 
reliability and users' dissatisfaction [Ref. 2:pp, 36-41] and 
[Ref. 3:pp. 132-142]. 

While significant progress has been made over the past 20 
years in improving the technology of software development, 
little research effort has been devoted to the managerial 
issues . 

Software Engineering Project Management (SEPM) has not 
enjoyed the same progress (as the technology of software 
development). While it might be argued that SEPM has 
been defined, it is far from a recognized discipline.... 

The major issues and problems of SEPM have not been 
agreed on by the computing community as a whole, and 
consequently, priorities for addressing them have not 
been widely established. Furthermore, research in this 
area has been scant. [Ref. 4:p. 333] 



B. THE DYNAMICA MODEL 

The goal of the Dynamica model is to provide an 
understanding of the dynamic behavior of software projects 
and support the management of the software development 
process [Ref. 5:pp. 8-10]. 



6 



The Dynamica model is a comprehensive system dynamics 
model of the software development process. The model 
integrates the multiple functions of the software development 
process, including both the management-type functions (e.g., 
planning, control, staffing) as well as the software 
production-type activities (e.g., design, coding, reviewing, 
testing) [Ref. 6:pp. 6-11]. Such an integrative approach is 

useful since it would prompt and facilitate a search for the 
multiple, and potentially diffuse set of factors that are 
interacting to cause some software project problem(s) [Ref. 
6:p. 14]. 

Another distinctive aspect of the Dynamica model is its 

use of computer simulation techniques to handle the high 

complexity of the integrative feedback model. 

The behavior of systems of interconnected feedback loops 
often confounds common intuition and analysis, even 
though the dynamic implications of isolated loops may be 
reasonably obvious. The feedback structures of real 
problems are often so complex that the behavior they 
generate over time can usually be traced only by 
simulation. [Ref. 7 : pp . 6-7] 

The Dynamica model consists of the four subsystems shown 
in Figure 2-1 [Ref. 5:p. 12]. The Human Resource Management 

Subsystem captures the hiring, training, assimilation and 
transfer of the project's human resources. The Software 
Production Subsystem captures the design, coding, quality 
assurance, rework, and testing activities [Ref. 6 : pp . 11-25]. 

The Planning Subsystem models the scheduling activities that 
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take place throughout the project's life cycle. The Control 
Subsystem captures the measurement of progress on the 
project . 
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Figure 2-1. Four Subsystems of The Dynamica Model 



C. RESEARCH OBJECTIVES 

The goal of this thesis is to design and develop a user 
interface for the Dynamica model which would improve the 
Dynamica model's utility as both a learning tool and a 
management support system. Three areas of the model 
interface are targeted for improvement: (1) ease of 



8 



operation, (2) improved facilities for accessing, storing and 
reviewing simulation results and (3) improved method of 
variable manipulation. 

The Dynamica model currently is extremely difficult for 
the new user to operate. For example, the model does not 
provide the user with a clear guide for operation and there 
is no online help or documentation available. These problem 
areas will be addressed through the design of a new menu type 
interface. The menu system will outline the functions 
available within the Dynamica model, explaining these 
functions, and make them easy to access and invoke. 

One of the major advantages of the Dynamica simulation 
model is its capability to provide the user with a dynamic 
and detailed picture of how model variables change throughout 
the project's life cycle. One of the goals of this thesis is 
to provide the user a easy method for data storage as well as 
plotting, graphing and printing the simulation results. 

A standardized report format and plot functions will be made 
available to the user via the menu system. 

Finally, the Dynamica model needs to provide the user 
with a framework for manipulating variables and controlling 
the model. Professional Dynamo provides the experienced 
model builder an executive interface language, Dynex, for 
creating an easily understood format for model manipulation. 

A goal of this thesis is the design and coding of a dynex 
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the 



interface for the model. This interface will contain 
definitions of 18 selected variables and allow their 
manipulation within the model. 
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Ill . INTERFACE DESIGN 



A. INTRODUCTION 

This chapter provides a detailed description of the user 
interface. It provides explanatory information on the 
portions of the interface visible to the user. In effect, it 
is a manual for the system, providing guidance on operating 
the system and explaining its characteristics. 

The user interface for the DYNAMICA MODEL OF SOFTWARE 
MANAGEMENT consists of three main parts: (1) the Model Menu 

and its Submenus, (2) 24 batch files called by the Model Menu 
and (3) the Model interface written in DYNEX (the executive 
interface language of Professional Dynamo). 

To operate the Dynamica model requires an IBM or IBM 
compatible XT/AT microcomputer, with 640 K of RAM and either 
a hard disk or 1.2 meg floppy disk. Microsoft (MS) or 
Personal Computer (PC) DOS 2 . xx or greater is also required. 

Section B of this chapter contains a complete tour of the 
user interface. 

B. THE MAIN MODEL MENU AND ITS SUBMENUS 

To initiate the main Model Menu type (menu) followed by 
enter/return at the DOS prompt of the directory containing 
the files of the system disk. Figure 3-1 will appear on the 
display. (For uniformity and clarity when reading interface 
documentation or prompts, the keystrokes required as input 
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will be placed in parenthesis. Unless otherwise stated, 
input may be lower or upper case.) 

MODEL MENU 

FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 

it'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kit'kiK'k'k'k'k'k'k'k'k'k'kit'k'k'k'k'k'k'k'M'k'k'k'k'k'k'k'k'k'k'k'k'k'kit'k'k-*:'^ 

1. INTRODUCTION TO THE MODEL MENU 

2. HELP FACILITIES 

3. VARIABLE MANIPULATION 

4. RUN SIMULATIONS 

5. TO STORE AND PRINT RESULTS 

6. VIEW RESULTS AND PRINT GRAPHS 

7. EXIT TO DOS 

Choose an option: (ESC exits menu) 

Figure 3-1. The Model Menu 

The user needs only to type the number of his/her 
selection and follow the prompts to move through any of the 
menu items selected. Pressing the escape key at any submenu 
will return the user to the next higher level menu until 
reaching the Model Menu's main screen Figure 3-1. 

The Model Menu provides the user six topic areas to 
choose from. Menu options are explained' below in the order 
listed in the Model Menu of Figure 3-1. All submenus of an 
option (e.g., selecting option 1 provides the user a submenu 
of the same title with three additional selections) will be 
discussed before proceeding to the next menu selection. 
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The first option on the main menu is INTRODUCTION TO THE 
MODEL MENU. If selected, the user is presented the submenu 
shown in Figure 3-2. 

INTRODUCTION TO THE MODEL MENU 
THE FOLLOWING MENU PROVIDES INTRODUCTORY INFORMATION TO 

NEW USERS 

***********************5»:*****it:****5»:*********5»r*****5t:******-** 

1. PURPOSE OF THE MODEL MENU 

2. HARDWARE/SOFTWARE REQUIREMENTS 

3. SUGGESTIONS FOR USING THE MENU 

Choose an option: (ESC exits menu) 

Figure 3-2. Introduction to the Model Menu 

The three user selections available in Figure 3-2, provide 
introductory information on the operation of the model menu. 
The three selections are (1) Purpose of the Model Menu, (2) 
Hardware/Software Requirements, and (3) Suggestions for 
Using the Menu, Figures 3-3, 3-4 and 3-5. 

After returning to the main Model Menu, selection of 
option # 2, Help Facilities, provides the user access to the 
submenu shown in Figure 3-6. 
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'k'kic'k'kic'k'k'k'k'k'kif'k'kit'kiciK'k'kif'k'k'k'k'k'k'k'kiC'k'kic'k'k'kificifiC'k'k'k'kic'kicic'k'k'k'k'kiKiC'k'k'k 



WELCOME 



WELCOyr: TO the model menu ! JUST BRIEFLY, 

LETS DISCUSS WHAT THE MODEL MENU IS AND WHAT 
IT ISN'T, TO HOPEFULLY AVOID ANY CONFUSION AS YOU 
BEGIN TO FAMILIARIZE YOURSELF WITH THE DYNAMICA 
MODEL OF SOFTWARE PROJECT MANAGEMENT. 

I. COMPONENTS OF THE MODEL MENU 

THE DYNAMICA MODEL OF SOFTWARE PROJECT 
MANAGEMENT IS A SOPHISTICATED SIMULATION MODEL 
WRITTEN BY DR. TAREK K . ABDEL-HAMID, IN PROFESSIONAL 
DYNAMO. PROFESSIONAL DYNAMO (ABBREVIATED PD ) IS 
A HIGH LEVEL SIMULATION LANGUAGE CREATED BY PUGH - 
ROBERTS ASSOCIATES, INC. 

ACCESS TO THE SYSTEM DYNAMICS MODEL OF 
SOFTWARE MANAGEMENT IS PROVIDED BY THE MODEL MENU. 

THE MODEL MENU, WRITTEN USING EXTENDED BATCH LANGUAGE, 
DOS COMMANDS, SEVERAL PUBLIC DOMAIN BATCH FILE 
UTILITIES AND THE PD INTERFACE LANGUAGE DYNEX, HAS 
BEEN DESIGNED TO EASE AND SPEED USER ACCESS TO THE 
MODEL AND AID IN THE MANIPULATION OF SIMULATION 
RESULTS. 

HIT ANY KEY TO CONTINUE. 



Figure 3-3. Purpose of the Model Menu 
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HARDWARE AND SOFTWARE REQUIREMENTS 

'k-kicic'k-kic'kic-:k'k'k-kic'k'k'ki(ic'k'k'kicicic'k'k-k-^ic'k'k-k'kic'k'k'kic'k'k'k'k'k-k'k'k-^-k'k'kicif-k'k'k'k'k'k 



HARDWARE: 

THE MODEL REQUIRES AN IBM OR IBM COMPATIBLE 
XT/AT MICROCOMPUTER, WITH 640 K OF RAM AND A HARD 
DISK OR 1.2 MEG FLOPPY. 

EXECUTION OF MODEL SIMULATIONS IS A VERY 
NUMERICALLY INTENSIVE OPERATION. THE EXECUTION 
SPEED INCREASES TREMENDOUSLY WITH THE USE OF A MATH 
CO-PROCESSOR CHIP. 

THE MODEL PROVIDES SUPPORT FOR THE MOST COMMON 
GRAPHIC DISPLAY MODES, MDA, CGA AND EGA. THE MODEL'S 
USE OF COLOR IS DESIGNED TO ENHANCE USABILITY BUT IS 
NOT A REQUIREMENT. 

SOFTWARE: 

THE MODEL REQUIRES MS OR PC DOS 2 . xx OR GREATER. 
CHECK TO MAKE SURE ALL THE FILES LISTED ON THE SYSTEM 
DISK ARE PRESENT IF ANY PROBLEMS ARISE. 

HIT ANY KEY TO CONTINUE 



Figure 3-4. 



Hardware and Software Requirements 



15 






SUGGESTIONS 

ititiiciKififir'kir'k'k'k'k'k'k'k'k'k'k'k'kir'k'if'k'kiK'k'k'ki^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kif'^'k'k'k-k'k'k'k'k'k'k 



THE FIRST RECOMMENDED ORDER OF BUSINESS FOR 
ALL NEW USERS IS TO FAMILIARIZE YOURSELVES WITH THE 
MODEL MENU. TAKE A FEW MOMENTS AND EXPLORE ALL THE 
MENU SELECTIONS. THERE IS NO NEED TO ENTER DATA OR 
RESPOND TO ANY OF THE QUERIES, JUST SCAN THE SCREENS 
AND HIT ENTER OR ANY KEY AS PROMPTED TO CONTINUE. 
THIS WHOLE PROCESS SHOULD ONLY TAKE YOU 10 MINUTES 
OR SO. 



HIT ANY KEY TO CONTINUE 



Figure 3-5.1. Suggestions for Using the Model 



REVIEW THE MODEL VARIABLES 



IF YOU PLAN TO USE THE MODEL TO SIMULATE A 
PARTICULAR SOFTWARE PROJECT THAT YOU HAVE DATA ON, 
THE MODEL bHOULD BE CUSTOMIZED TO REFLECT THAT 
PROJECT. YOUR FIRST STEP TOWARDS THAT GOAL OF MODEL 
PARAMETERIZATION IS TO REVIEW THE DEFINITIONS OF 
THE ADJUSTABLE VARIABLES WITHIN THE MODEL. THESE 
DEFINITIONS ARE AVAILABLE BY SELECTING # 3, 

VARIABLE MANIPULATION FROM THE MODEL MENU. 



HIT ANY KEY TO CONTINUE 



Figure 3-5.2. Suggestions for Using the Menu 
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HELP FACILITIES 

INTRODUCTION TO DYNAHICA AND PROFESSIONAL 
DYNAMO HELP FACILITIES 

1. OVERVIEW OF HELP FACILITIES 

2. ONLINE MODEL HELP INFORMATION 

3. PROFESSIONAL DYNAMO HELP 

Choose an option: (ESC exits menu) 

Figure 3-6. Help Facilities 



Selection # 1, Overview of Help Facilities, provides the 
user with an explanation of the two types of help facilities 
available in the model Figure 3-7. 



OVERVIEW OF AVAILABLE HELP FACILITIES 



THERE ARE TWO TYPES OF HELP AVAILABLE TO THE USER: 

(1) ONLINE MODEL HELP 

(2) PROFESSIONAL DYNAMO HELP 



(1) ONLINE MODEL HELP IS AVAILABLE TO THE USER 
WHEN UTILIZING SELECTION # 3 OF THE MAIN MENU - 
VARIABLE MANIPULATION. AT ANY PROMPT, THE USER 
NEED ONLY TO TYPE ( H ) ELP (H)ELP TO GET A LIST OF 
AVAILABLE HELP CATEGORIES. 

(2) PROFESSIONAL DYNAMO HELP PROVIDES THE MORE 
EXPERIENCED MODEL USER ACCESS TO 8 PD HELP TOPICS. 



HIT ANY KEY TO CONTINUE 



Figure 3-7. Overview of Help Facilities 
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Selection # 2 , Online Model Help Information, explains 
the operation and capabilities of online model help Figure 
3-8. 

Selection # 3 , Professional Dynamo Help, presents the 
user a submenu containing a list of the PD Help Facilities 
available Figure 3-9. Professional Dynamo Help is listed in 
Appendix C. 



-k-k'k'k'k'k'k'k-k'k-k'k-k'k'k'k'k'k'k'k'k'k-k'k'k'k'k'k'k'k'k. 'k'k'k'k'k-k'k'k-k'k'k'k'k'k'k'k'k-k'k'k'k'k'k-k'k'k'k'k 



ONLINE MODEL HELP INFORMATION 

'k'k'k'k-k-k'k'k'k-k'k-k'k'k'k'k'k'k'k'k'k-k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k'k-k'k'k'k-k-k'k-k-k-k'k-k'k'k'k'k'k'k'k-k'k 



THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGE- 
MENT HAS THE CAPABILITY FOR EXTENSIVE, USER DEFINED, 
EASILY MODIFIABLE HELP. ACCESS TO THIS HELP IS 
AVAILABLE WHILE UTILIZING MAIN MENU SELECTION # 3, 
MODEL & VARIABLE MANIPULATION. THIS HELP CAPABILITY 
IS A FEATURE OF PROFESSIONAL DYNAMO, DESIGNED BY 
PUGH-ROBERTS ASSOCIATES, INC. 

TO ACCESS AN EXAMPLE OF THIS HELP, THE USER 
SIMPLY TYPES (H)ELP ( H ) ELP FOLLOWED BY ENTER. 



HIT ANY KEY TO CONTINUE 



Figure 3-8. Online Model Help Information 
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PROFESSIONAL DYNAMO HELP 
THE FOLLOWING MENU PROVIDES ACCESS TO 
PD HELP FACILITIES 

1. OVERVIEW OF PD HELP 

2. DYNEX HELP 

3. EDITOR HELP 

4. SIMULATION HELP 

5 . TOOLS HELP 

6. TRANSLATOR HELP 

7. UTILITIES HELP 

8. VIEW HELP 

Choose an option: (ESC exits menu) 

Figure 3-9. Professional Dynamo Help 

Returning to the main menu, we now discuss Model Menu 
option # 3, Variable Manipulation. The objective of this 
selection is define the variables for the new user and allow 
manipulation of these variables in the Dynamica model. This 
is accomplished via the Dynex Model Interface, written for 
this thesis in Professional Dynamo's executive level 
programming language Dynex. 

The Dynex interface allows the user to view and 
manipulate variable values within the model. After selecting 
Variable Manipulation the user is presented Figure 3-10. The 
purpose of Figure 3-10 is simply to acknowledge to the user 
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that the selection has been activated and to prevent him from 
having to stare at a blank screen for the four to five 
seconds required to load the Dynex Interface. The local time 
and date will be displayed if the computer in use has a 
battery powered clock/calendar. 



THE MODEL IS BEING LOADED ! 

Local Time 
Local Date 



Figure 3-10. Variable Manipulation 



After the Dynex Model 
be presented Figure 3-11. 



Inter face 



is loaded the user will 



*********************************************************** 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 

March 1988 

*********************************************************** 

Press ENTER for a brief introduction to Model 
and Variable Manipulation. It is suggested 
reading for all new users of Dynamica. 

Experienced users will most likely want to 
skip directly to Model and Variable Manipulation. 

To do so type (n)o followed by Enter. 



Press Enter or (n)o followed by Enter 
to Continue 



Figure 3-11. Dynex Interface Introduction 



The introduction, shown in full in Figures 3-12, 3-13, 
3-14 and 3-15, is appropriate for new users of the Dynamica 
model, but may be skipped if desired by the experienced user. 
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The Dynex Model Interface then identifies, and defines 
the 18 model variables in Figures 3-16 and 3-17 which are 
available to the user to manipulate. The variables are 
divided into four categories: (1) Estimated Actual Project 

Size, (2) Variables Characteristic of the Organizational 
Environment, (3) Policy Variables, and (4) Model Control 
Var iables . 



*********************************************************** 

WELCOME TO PROFESSIONAL DYNAMO AND THE DYNAMICA MODEL 

OF SOFTWARE PROJECT MANAGEMENT page 1 

*********************************************************** 



INTRODUCTION 



Professional Dynamo is a high level model simula- 
tion language that has been used to create THE DYNAMICA 
MODEL OF SOFTWARE MANAGEMENT. You need to have no 
knowledge of how Professional Dynamo works to use the 
model . 



THE DYNAMICA MODEL OF SOFTWARE PROJECT 
here after simply referred to as DYNAMICA, 
sophisticated simulation model designed to 
assistance in understanding and estimating 
and complex variables dynamically involved 
software development project. 



MANAGEMENT, 
is a 
provide 
the numerous 
in a large 



Press Enter to Continue 



Figure 3-12. Dynex Interface page 1 






Introduction 



page 2 
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To speed you on your way, a menu system has been 
developed to help you access the model which is 
written in PROFESSIONAL DYNAMO. This menu allows the 
user to customize the model to fit a specific software 
project and conduct "what if" type experimentation. 

The user may access any of 18 variables or table 
values, from four categories. 



Press Enter to Continue 



Figure 3-13. Dynex Interface page 2 






Introduction 



page 3 



**********************************************************:► 



When addressing a particular variable, the user 
may chose any value or use a previously defined value. 
Changes to variables from your last simulation are 
automatically stored with your simulation results if 
you chose to store your results. 

Your first step after you become familiar with the 
mechanics of the model will be to adjust all the perti- 
nent variables to customize the model to represent any 
specific software project you might have in mind. 
Otherwise, you may use the model "as is", to conduct 
your experimentation in the relationships of the 
var iables . 



Press Enter to Continue 



Figure 3-14. Dynex Interface page 3 
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Introduction 



page 






The DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT has 
the potential for extensive online help facilities. 
Currently, only one aspect of the online help facility is 
employed, that being HELP on HELP. This has been done to 
demonstrate the available capability. To view the HELP on 
HELP, type (h)elp followed by a space and (h)elp again 
followed by striking the enter/return key. 



Press Enter 



to Continue 



Figure 3-15. 



Dynex Interface page 4 






VARIABLE MANIPULATION page 5 



The following 18 model variables of Dynamica are 
adjustable via the raenn 

They are grouped in 4 categories for easy access. 

I. ESTIMATED ACTUAL PROJECT SIZE 



1. RJBDSI Real Job Size in DSI 

II. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 

A. Productivity 

2. DSIPTK Delivered Source Instruction 

Per Task 

B. Quality 

3. TNERPK Error Rate Per 1000 Delivered 

Source Instruction 

C. Staffing Variables 

4. HIREDV Hiring Delay 

5. ASIMDY Assimilation Delay 



III . 



6. AVEMPT Average Employment 

POLICY VARIABLES 

A. Estimation 

7. UNDEST Task Underestimation Factor 

8. TOTMDl ..Total Mandays 

9. TDEVl Time to Develop 



Press Enter To See the Remaining Variables 



Figure 3-16. Dynex Interface page 5 



24 



iiciicifirifififirifiKifir'k'k'k'k'k'k'k'kiK'k'kir'k'k'k'k'k'^'k'k'k'k'k'k'k'k'k'k'k-kiC'k'k'k'k'k'k'k'k'k'k'k’k'k'k’k'k 



MODEL AND VARIABLE MANIPULATION page 6 

iicirififi(:'k'k'k'kif'k'ic'k'k'k'k'k'k'k'kic'k'k'k'kicif'k’k'k:k'k'k^'k'k'k'k'k'k'k'i:'k'k’k-k'k'k’k'k'ki('k'k'kic'ki:'k 



B. Resource Allocation 

10. DEVPRT of Effort Assumed Needed for 

Development 

11. TPRMQA .... Fraction of Manpower Devoted to 
Quality Assurance 

12. INDUST Initial Unders taf f ing Factor 

13. WCWFl Willingness to Change the 

Workforce 

C. Staffing 

14. TRPHNR % of Experienced Employee 

Effort to Train a New Employee 

15. AMPPS Average Daily Manpower /Staff 

Expended on Project 

IV. MODEL CONTROL 

16. MAXLEN Max Length of Project 

17. SAVPER Save Period for Data 



Press Enter to See Variable Definitions 
or to Manipulate Variable Values. 



Figure 3-17. Dynex Interface page 6 
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The user may select to first look, at a brief explanation 
of the variables, or go directly to variable manipulation as 
shown in Figure 3-18. To make a selection, type the number 
of the choice or choices, separating each number by a space 
or a comma. If no choice or an illegal choice is made, Dynex 
will prompt the user to reenter all of his choices again. 



MODEL AND VARIABLE DEFINITION AND MANIPULATION page 7 

************************************************************ 

Select one or more of the following eight topic areas. 
You may chose to first look at a brief explanation of the 
variables or go directly to variable manipulation. 

I. MODEL VARIABLE DEFINITIONS 

1. ESTIMATED ACTUAL PROJECT SIZE DEFINITION 

2. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT DEFINED 

3. POLICY VARIABLES DEFINED 

4. MODEL CONTROL VARIABLES DEFINED 

II. MANIPULATION OF MODEL VARIABLES 

5. ESTIMATED ACTUAL PROJECT SIZE 

6. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 

7. POLICY VARIABLES 

8. MODEL CONTROL VARIABLES 



Enter the number(s) of your selected choices. 
Separate each choice by a space or a comma. 



Figure 3-18. Dynex Interface page 7 



Selection of choice # 1 from Figure 3-18, provides the 
user the definition of Estimated Actual Project Size Figure 
3-19. The user is automatically returned to the main Model 
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Menu after reviewing the last choice selected. Let us assume 
for the sake of this tour that the user has selected all 
eight choices. 

i 

'k’k'kic-k'k-k-k'k'k-k'k'k-k’k'kic'k'k'k'k'k'k'k'k'kic'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k^kicic'k'k'k'k'k’k'k'k'k-k'k'k 

ESTIMATED ACTUAL PROJECT SIZE DEFINITION page 8 
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REAL JOB SIZE IN DSI RJBDSI 

The real size of the software project in delivered 
source instructions (DSI) with comments. The following 
definitions are from Boehm, 1981. 

Delivered. This term is generally meant to exclude 
nondelivered support software such as test drivers. 
However, if these are developed with the same care as 
delivered software, with their own reviews, test plans, 
documentation, etc., then they should be counted. 

Source Instructions. This term includes all program 
instructions created by project personnel and processed 
into machine code by some combination of preprocessors, 
compilers, and assemblers. It excludes comment cards 
and unmodified utility software. It includes job 
control language, format statements and data declarations. 
Instructions are defined as lines of code or card images. 
Thus, a line containing two or more source statements 
counts as one instruction; a five-line data declaration 
counts as five instructions. 



Press Enter to Continue 



Figure 3-19. Dynex Interface page 8 

Selection # 2, Variables Characteristic of the 
Organizational Environment, presents the user the five 
variables definitions shown in Figures 3-20, 3-21, and 3-22. 
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*********************************************************** 



VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 



ENVIRONMENT DEFINITION page 9 

*********************************************************** 

DELIVERED SOURCE INSTRUCTION PER TASK DSIPTK 



This parameter is set to the value of the nominal 
potential productivity in the organizational environ- 
ment being modeled. For example, if the nominal 
potential productivity is 50 DSI/Man-Day then DSIPTK 
would be set to 50. 



ERROR RATE PER 1000 DELIVERED SOURCE 

INSTRUCTIONS (KDSI) TNERPK 

TNERPK is the number of errors committed on the 
average, per 1000 DSI, as the softwarz- .project is being 
developed. It is not a single number but rather a table 
function. This allows the user to set different error 
rates at different stages of the project's lifecycle. 



Press Enter to Continue 



Figure 3-20. Dynex Interface page 9 



VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT DEFINITION page 10 

HIRING DELAY HIREDY 

HIREDY is the average delay time, in work, days, 
incurred in adding new staff members to the project. 

ASSIMILATION DELAY ASIMDY 

ASIMDY is the average time needed to assimilate newly 
hired personnel into the project, measured in workdays. 

It is the time required for orientation, institutionali- 

zation and training. 

Press Enter to Continue 



Figure 3-21. Dynex Interface page 10 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT DEFINITION page 11 
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AVERAGE EMPLOYMENT AVEMPT 

AVEMPT is the average employment time of project team 
members, measured in working days. It is indirectly 
proportional with TURNOVER. For example, the smaller the 
AVEMPT the larger the turnover rate, and conversely, the 
smaller the turnover rate the higher the AVEMPT. 



Press Enter to Continue 



Figure 3-22. Dynex Interface page 11 



Selection # 3, Policy Variables, presents the user the 
definitions of the seven policy variables shown in Figures 
3-23, 3-24, 3-25, 3-26, and 3-27. 

Selection of # 4, Model Control Variables, presents the 
user the definitions shown in Figure 3-28. The Dynex 
interface allows the user to adjust two model control 
variables. These variables provide the user control over 
two aspects of model operation. 
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POLICY VARIABLES DEFINITIOMS 



page 12 
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TASK UNDER ESTIMATION FACTOR UNDEST 

Undersizing is a large problem in project management. 
This variable allows the to experiment with different 
values of underestimates. Thus to simulate a situation 
where the project size is initially underestimated by 
25%, this variable would be set to 0.25. 



TOTAL MAN DAYS TOTMDl 

TOTMDl is the man-day estimate produced at the start 
of the project, for design, coding and system testing of 
the project. 



TIME TO DEVELOP TDEVl 

TDEVl represents the estimated time, measured in work 
days, for the design, coding and testing stages of the 
project, produced at the start of the project. For example, 
if the initial project duration estimate was 16 months, 
TDEVl would be equal to (16 x 20) or 320 working days. 



Press Enter 



to Continue 



Figure 3-23. 



Dynex Interface page 12 
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POLICY VARIABLES DEFINITIONS page 13 
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% OF EFFORT ASSUMED NEEDED FOR DEVELOPMENT DEVPRT 

This variable is used to allocate the projected total 
budget, measured in Man-Days, for the development (which 
includes design and coding) and testing phases. For 
example, if it is decided that 80% of the total Man-Days 
would be allocated to development and 20% to testing, then 
DEVPRT would be set to 0.80. 



FRACTION OF MANPOWER DEVOTED TO QUALITY ASSURANCE . . . . TPFMQA 
TPFMQA is the percent of development effort allocated 
in the project's plan for QA activities during the design 
and coding stages. It is not a single number but rather a 
table function that allows the user to change the number 
of Man-Days allocated to QA at different stages in the 
project lifecycle. A value of 0.20 at some point in the 
project would indicate that at this point, 20% of the 
Man-Day budget is allocated to QA . 



Press Enter to Continue 



Figure 3-24. Dynex Interface page 13 
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POLICY VARIABLES DEFINITIONS page 14 

INITIAL UNDERSTAFFING FACTOR INDUST 

The project's average staffing level is equal to the 
project's total number of Man-Days divided by the project's 
scheduled duration. Typically, the project will start with 
a small core team which grows in size. This variable 
specifies the size of the starting group. Thus a value of 
0.5 indicates that the startup team is half the size of the 
average staff size. 



Press Enter To Continue 



Figure 3-25. Dynex Interface page 14 
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POLICY VARIABLES DEFINITIONS page 15 



WILLINGNESS TO CHANGE THE WORKFORCE WC'*”^! 

On deciding upon a "Workforce" level desired, project 
managers typically consider a number of factors. One 
important factor is the project's scheduled completion date. 
As part of the planning function, management determines the 
workforce level that it believes is necessary to complete the 
project on schedule. In addition to this factor, considera- 
tion is also given to the stability of the workforce. Thus, 
before adding new project members, management tries to 
contemplate the project employment for new members. 

Different organizations weigh this factor differently. In 
general, the relative weighing between the desire for work- 
force stability on one hand and the desire to complete the 
project on time, on the other, is not static, but changes 
dynamically throughout the lifecycle of the project. For 
example, toward the end of the project there is typically 
considerable reluctance to bring in new people, even if the 
project is behind schedule. It would take too much time and 
effort ( relative to the time and effort that are remaining) 
to acquaint new people with the mechanics of the project, 
integrate them into the project team and train them in the 
necessary technical areas. 



Press Enter for More Information of WCWFl 
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WCWFl DEFINITION CONTINUE 



page 16 






These managerial considerations are operational in the 
model as follows: WORKFORCE LEVEL NEEDED = (INDICATED 

WORKFORCE LEVEL) * (WCWF) + (CURRENT WORKFORCE) * (1-WCWF) 

The Weighting Factor (WCWF) is termed Willingness to 
Change the Workforce. 

In the early stages of the project when "Time Remaining" 
is generally much larger than the sum of "Hiring Delay" and 
the "Average Assimilation Delay" WCWF would be equal to 1. 
When WCWF is = 1, the "Workforce Level Needed" in the above 
equation would simply be equal to the "Indicated Workforce 
Level," i.e., management would be adjusting its workforce 
size to the level it feels is needed to finish on schedule. 
The "Indicated Workforce Level" can be determined by dividing 
the amount of effort that management perceives is still 
remaining (in Man-Days) by the time remaining to complete the 
project in days. 

When the "Time Remaining" decreases, ASSIMILATION DELAY 
(ASIMDY) could be set to equal exactly 0. The "Workforce 
Level Needed" in the equation would thus be equal to the 
"Current Workforce" i.e., management attempts to maintain 
the projects workforce at its current level, and make 
adjustments to the schedule instead. 

Press Enter to Continue 



Figure 3-26. Dynex Interface page 16 



POLICY VARIABLE DEFINITIONS page 17 



NEW EMPLOYEE TRPHNR 

organizations, training of new employees is 
out by the more experienced employees. This variable 
the fraction of an experienced staff member's time 
devoted to train new hirees. For example, a value of 
0.2 indicates that on the average each new employee consumes 
20% of an experienced employee's time for the duration of 
the assimilation delay. 



TRAINERS PER 
In most 
carried 
defines 
that is 



AVERAGE DAILY MANPOWER PER STAFF EXPENDED 

ON PROJECT ADMPPS 

Project members are often only assigned part-time to 
a project. ADMPPS defines the % of time that the team 
members devote, on an average to the particular project being 
simulated. For example, if staff members tend to divide 
their time equally between two projects, i.e., half of their 
time is spent on project A and the other half is spent on 
project B, then ADMPPS would be = 0.5. 



Press Enter to Continue 



Figure 3-27. 



Dynex Interface page 17 
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MODEL CONTROL VARIABLE DEFINITIONS page 18 



MAX LENGTH OF PROJECT MAXLEN 

This model control variable is useful in controlling 
the simulations. It precludes the model from continuing a 
simulation beyond a predetermined length, e.g., 1000 days. 

SAVE PERIOD FOR DATA SAVPER 

This model control variable allows the user to adjust 
the models save period for data for later viewing. For 
example, if the user sets the SAVPER = 1, the model will save 
all variable values on a daily basis, this data would be 
available for the user to examine and plot at the end of a 
simulation. A SAVPER of 10, saves values every 10 days. This 
provides the user with a trade off between the time required 
for a simulation and the level of detail of the results. 



Press Enter to Continue 



Figure 3-28. Dynex Interface page 18 

Selections # 4-8 provide the user the opportunity to 
manipulate the variables defined by the first four 
selections. When the user selects any category of model 
manipulation, the current value of each variable is displayed 
as shown in Figures 3-29 - 3-43. To change a variable enter 
the value desired and depress enter/return. If the user 
wishes to use the current value simply press enter /re turn . 

In either case the next variable to be manipulated will be 
displayed or the user will be automatically returned to the 
Model Menu if no other variables have been selected. 
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*********************************************************** 

ESTIMATED ACTUAL PROJECT SIZE VARIABLE MANIPULATION page 19 
*********************************************************** 

REAL JOB SIZE IN DELIVERED SOURCE INSTRUCTIONS RJBDSI 

Enter a new value for REAL JOB SIZE IN DELIVERED SOURCE 
INSTRUCTIONS or press enter to use the preset value. The 
preset value is written using a form of scientific notation 
where e3 represents x 10 to the third power. You do not have 
to enter a value in that format but be aware that the model 
will represent numbers in that format. 

24. 4e3 



Figure 3-29. Dynex Interface page 19 



********************************************************** 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 20 

*********************************************************** 



Enter a new value for DELIVERED SOURCE INSTRUCTIONS PER 
TASK or press enter to use the preset value. 

40 . 0 



Figure 3-30. Dynex Interface page 20 



Although most variables are a single value, some of the 
variables have more then one value and are referred to as 
table values. Examples of table values are shown in Figures 
3-31, 3-31.1, 3-36, 3-38 and 3-40. Figures 3-31, and 3-31.1 
show that the user enters all six table values, separating 
each value by either a space or comma, before depressing 
enter/return. Table values generally represent variables 
whose values change over time. Dynex will prompt the user to 
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respond again if an incorrect number of variables are 
entered. The method of entering multiple variables is the 
same as selecting multiple choices from a Dynex Menu, each 
choice must be separated by a space or a comma. 



VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 21 

*★★★*★★★**★***★★★*★★*★*★★★★★*★★***★★★★★★★***★★★★★★*★*■**★★★★ 

Enter a new value for ERROR RATE PER 1000 DELIVERED 
SOURCE INSTRUCTIONS or press enter to use the preset table 
values . 

1 2 3 4 5 6 



Figure 3-31. 



Dynex Interface page 21 



VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 21 

******Hr*i(r********Hr******************5^Hr********************* 



Enter a new value for ERROR RATE PER 1000 DELIVERED 
SOURCE INSTRUCTIONS or press enter to use the preset table 
values . 

1 2 3 4 5 6 

24.0 22.9 20.75 15.25 13.1 12.0 



F igure 3-31. 1 . 



Dynex Interface page 



21 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 22 

*********************************************************** 



Enter a new value for HIRING DELAY or press enter to use 
the preset value. 

30 . 0 



Figure 3-32. Dynex Interface page 22 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 23 
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Enter a new value for ASSIMILATION DELAY or press enter 
to use the preset value. 

20 . 0 



Figure 3-33. Dynex Interface page 23 



VARIABLES CHARACTERISTIC OF ORGANIZATIONAL 

ENVIRONMENT MANIPULATION page 24 

*********************************************************** 



Enter a new value for AVERAGE EMPLOYMENT or press enter 
to use the preset value. 

1000 



Figure 3-34. Dynex Interface page 24 
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The user is provided two methods of entering values for 
the variables Total Man-Days and Time to Develop as shown in 
Figure 3-35. The values may be entered directly, similar to 
the other variables or the user may elect to have the model 
compute both values using COCOMO. 

POLICY VARIABLE MANIPULATION page 25 



For assigning values to TOTAL MANDAYS and TIME TO 
DEVELOP the user may either: 

1. Calculate the two values external to the model 
and input them directly at the prompt below. 

OR 

2. Allow the model to calculate the two values 
internally utilizing COCOMO by imputing 0 for 
each of the 2 variables at the COCOMO 
PROMPT. 

TOTMDl 1111 
TDEVl 320.0 



COCOMO PROMPT: 

Enter 1 at the next two prompts to allow COCOMO to compute 
TOTMDl AND TDEVl. OR enter 0 to use your own values input 
above . 



Press Enter to Continue 



Figure 3-35. Dynex Interface page 25 
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POLICY VARIABLES MANIPULATION page 26 

'ki(i(i(i<'kifi<i<'ki(i(i<'ki(i<'k'k'ki(i(i(i(i<i(i(i(iei('ki<i<i<i(ie'ki<'k'ki(i<i('k'k'ki('k'ki<'k'k'ki(ici(i('k'k'k 

Enter a new set of table values for the TASK UNDER 
ESTIMATION FACTOR or press enter to use the preset value. 

123456789 10 11 

Figure 3-36. Dynex Interface page 26 

*********************************************************** 

POLICY VARIABLES MANIPULATION page 27 

*********************************************************** 

Enter a new value for % OF EFFORT ASSUMED NEEDED FOR 
DEVELOPMENT or press enter to use the preset value. 

. 5 

Figure 3-37. Dynex Interface page 27 

*********************************************************** 

POLICY VARIABLES MANIPULATION page 28 

*********************************************************** 



Enter a new value for FRACTION OF MANPOWER DEVOTED TO 
QUALITY ASSURANCE or press enter to use the preset value. 

12 3456789 10 11 

Figure 3-38. Dynex Interface page 28 
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POLICY VARIABLES MANIPULATION page 29 

★ *★**★★★★*★**★★*★★***★**★★★*★***★★★★★★★★**★*★***★*★★★★★★★** 



Enter a new value for INITIAL UNDERSTAFFING FACTOR or 
press enter to use the preset value. 

. 4 



Figure 3-39. Dynex Interface page 29 



★ ★★***★★**★**★★★★★★*★**★*★★★***★★**★*★★**★****★★****★★★*★** 

POLICY VARIABLES MANIPULATION page 30 

*********************************************************** 



Enter a new value for WILLINGNESS TO CHANGE THE WORKFORCE 
or press enter to use the preset table values. 



1 2 3 4 5 6 7 8 9 10 11 12 13 14 



Figure 3-40. Dynex Interface page 30 



POLICY VARIABLES MANIPULATION page 31 



Enter a new value for PERCENT OF EXPERIENCED EMPLOYEE 
EFFORT TO TRAIN A NEW EMPLOYEE or press enter to use the 
preset value. 

. 25 



Figure 3-41. Dynex Interface page 31 
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POLICY VARIABLES MANIPULATION page 32 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 



Enter a new value for AVERAGE DAILY MANPOWER PER STAFF 
EXPENDED ON PROJECT TO TRAIN A NEW EMPLOYEE or press enter 
to use the preset value. 

. 5 



Figure 3-42. Dynex Interface page 32 



MODEL CONTROL VARIABLE MANIPULATIONS page 33 

Enter a new value for MAX LENGTH OF PROJECT or press 
enter to use the preset value. 

1000 

Figure 3-43. Dynex Interface page 33 

MODEL CONTROL VARIABLE MANIPULATIONS page 34 
**************************************)>******************** 



Enter a new value for SAVE PERIOD FOR DATA or press 
enter to use the preset value. 

10 



Figure 3-44. Dynex Interface page 34 



42 



Figure 3-44 is the last screen in the Dynex Model 
Interface. The user is automatically returned to the main 
Model Menu. 

After returning to the main Model Menu, selection # 4, 

Run Simulation, allows the user to run a model simulation 
with the variable values selected via main Model Menu 
selection # 3. After selecting Run Simulation the user views 
Figure 3-45 while the Dynamica model is prepared for 
simulation. 

THE MODEL IS BEING PREPARED FOR A SIMULATION ! 

Local Time 
Local Date 



Figure 3r45. Run Simulation 



After loading the Dynamica model automatically runs the 
simulation. Upon conclusion of the simulation run, the user 
is automatically returned to the main Model Menu. 

Selection of Model Menu # 5, To Store and Print Results, 
provides the user access to the submenu shown in Figure 3-46. 
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*********************************************************** 

TO STORE AND PRINT RESULTS 
THIS MENU ALLOWS THE USER TO STORE AND PRINT 
SIMULATION RESULTS 

1. STORING STATISTICS 

2. PLOTTING RESULTS 

3. PRINTING YOUR RESULTS 

Choose an option: (ESC exits menu) 

Figur*^ 3-46. To Store and Print Results 

The user is provided three submenu selections in Figure 
3-46: (1) Storing Statistics, (2) Plotting Results and (3) 

Printing Your Results. 

If # 1, Storing Statistics is selected, the model 
collects statistics from the previous simulation and places 
them in a predefined report format. This report format may 
be adjusted utilizing Professional Dynamo, to suit the user's 
needs. This report may then be stored under a file and in a 
directory of the user's choice for future reference Figure 
3-47. Any changes to variables from the previous simulation 
run will be appended and stored at the bottom of the report. 
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YOUR RESULTS ARE BEING STORED IN THE PROPER FORMAT ! 



Local Time 
Local Date 

PLEASE ENTER THE FILE NAME YOU DESIRE FOR THIS REPORT. 
IT IS SUGGESTED THAT YOU NAME YOUR FILES IN A MANNER 
WHICH WILL ALLOW THE MAXIMUM BENEFITS OF THE DOS 
WILDCARD ( * ) FEATURE WHEN MANIPULATING YOUR FILES. 

EXAMPLE: (PROJECT.*) 

NOTE: CHANGES MADE TO VARIABLES ARE APPENDED TO THIS 

FILE. FOR EXAMPLE IF HIRING DELAY WAS CHANGED 
FROM 30 TO 40, THAT INFORMATION WOULD BE STORED 
AT THE END OF THE REPORT. 

ENTER THE FULL PATH NAME OF THE DIRECTORY WHERE 
YOU WOULD LIKE THE RESULTS STORED. 



Figure 3-47. Storing Statistics 



At the conclusion of Storing Statistics, the user is 
automatically returned to Figure 3-46. 

Selecting # 2, Plotting Results, provides the user access 
to the submenu shown in Figure 3-48. 



PLOTTING RESULTS 

THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND 
SAVE 4 PREDEFINED PLOTS 



1. OVERVIEW PLOTTING FUNCTIONS 

2 . PLOT 1 

3. PLOT 2 

4 . PLOT 3 

5. PLOT 4 

Choose an option: (ESC exits menu) 

Figure 3-48. Plotting Results 
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There are five selections available in Figure 3-48. 
Selection # 1, Overview of the Plotting Functions, provides 
the user an introduction to the origin and purpose of a set 
of four predefined plots, selections # 2-5 Figure 3-49. 
Selecting any of the predefined plots presents the user a 
list of the variables plotted by that selection Figures 3-50, 
3-51, 3-52 and 3-53. The variables are then plotted and the 
user is given the option of printing the plot if so desired. 



OVERVIEW OF PLOTTING FUNCTIONS 
*********************************************************** 



The Dynamica model can create plots of preselected 
variables. Each Plotting function, contains a list of the 
variables plotted by that menu selection. Viewing a plot is 
simply a matter of selecting the number of the plot desired. 
These plots may be printed using the print function of the 
included menu. 



HIT ANY KEY TO CONTINUE ! 



Figure 3-49. Overview of Plotting Functions 
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PLOT 1 

ifi(i(i(ici<iKi<i(i(i(icic'kici^i(iKi^i<ici('k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'ki('k'k'k'k'k'kic'k'k'k'k'k'k'k'k 



PLOT 1 GRAPHS THE FOLLOWING VARIABLES: 



SCHCDT ESTIMATED SCHEDULE IN DAYS 

PJBSZ PERCEIVED PROJECT SIZE IN TASKS 



JBSZMD ESTIMATED PROJECT COST IN MAN-DAYS 



TOTWF TOTAL WORKFORCE PEOPLE 

CUMMD CUMULATIVE MAN-DAYS EXPENDED 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 

Figure 3-50. Plot 1 

PLOT 2 

FIRST, A QUICK REVIEW OF THE VARIABLES BEING 



PLOTTED: 

CMTKDV CUMULATIVE TASKS DEVELOPED 

CUMTKT CUMULATIVE TASKS TESTED 

CUMMD CUMULATIVE MAN-DAYS EXPENDED 

PJBSZ PERCEIVED PROJECT SIZE IN TASKS 

PDEVRC ESTIMATED % DEVELOPMENT COMPLETE 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 

Figure 3-51. Plot 2 
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PLOT 3 

'k'k'k'k'k'k'k'k'k'k'k'M'k'k'k'k'k'M'k'k'kit'k'k'k'k'k'kif'k'k'k'k'k'kit'k'k'k'kiK'k'M'k'k'k'k'k'k'k'k'k'k'M'kic'k'k'k 

FIRST, A QUICK REVIEW OF THE VARIABLES BEING PLOTTED: 



TOTWF TOTAL WORKFORCE 

FRWFEX FRACTION OF WORKFORCE THAT IS 

EXPERIENCED 

SDVPRD PRODUCTIVITY 

COMMOH COMMUNICATION OVERHEAD 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



Figure 3-52. Plot 3 



PLOT 4 

FIRST, A QUICK REVIEW OF THE VARIABLES BEING PLOTTED: 



AFMPDJ ACTUAL FRACTION OF A MAN-DAY ON 

PROJECT 

JBSZMD PERCEIVED TOTAL JOB SIZE IN 

MAN-DAYS 

PJBSZ PERCEIVED JOB SIZE IN TASKS 

PMDSHR PERCEIVED SHORTAGE IN MAN-DAYS 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



Figure 3-53. Plot 4 
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When the user is finished with the plotting functions, 
pressing the escape key returns Figure 3-46 to the screen. 

The last option available to the user in Figure 3-46 is 
selection # 3, Printing Your Results. Selection of choice # 
3, Printing Your Results, allows the user to print any files 
to an attached printer. The user is asked to type only the 
name of the file to be printed. The use of DOS wildcard 
symbols is suggested to aid in printing large numbers of 
files at a time Figure 3-54. The DOS command graphics has 
been entered for the user, to allow the use of bit mapped 
graphics for suitably configured printers. 

PLEASE ENTER THE FULL NAME OF THE FILE YOU WOULD LIKE 

PRINTED. YOU MAY USE DOS WILDCARD ( * ) SYMBOLS FOR 

PRINTING MORE THEN ONE FILE AT A TIME. 

OTHERWISE, PLEASE TYPE (Q) TO QUIT. 

EXAMPLE: (MONDAY.*) 

Figure 3-54. Printing Your Results 

Typing (Q)uit returns the user to Figure 3-46. To return to 
the main Model Menu press escape. 

Selection of # 6, from the Model Menu, View Results and 
Print Graphs, allows the user to view statistical results on 
any or all of 46 performance parameters measured for each 
simulation or create graphs for any of 30 variables. After 
selecting # 6, the user is queried as to the graphics card 
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capability of the computer in use Figure 3-55. This allows 
graphs to oe displayed and printed at the maximum resolution 
for the equipment in use. 

YOUR RESULTS ARE BEING PREPARED FOR VIEWING ! 

IF YOU HAVE AN EGA GRAPHICS CARD TYPE (y) 

FOLLOWED BY ENTER. 

IF YOU DO NOT HAVE AN EGA CARD TYPE (n) 

FOLLOWED BY ENTER. 

Figure 3-55. View Results and Print Graphs 

The user may return to the main Model Menu by pressing escape 
or quit at the prompt after making any number of graphs 
des ired . 

The final selection of the main Model Menu is # 7, Exit 
To Dos. This selection simply returns the user to the DOS 
prompt in the directory where the user interface is stored. 

To return to the Model Menu, type (menu) and depress 
enter /return. 
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IV. SYSTEM ARCHITECTURE 



A. OVERVIEW OF THE SYSTEM ARCHITECTURE 

A system architecture overview of the user interface 
created in this thesis is depicted in Figure 4-1. There are 
three interrelated subsystems represented at this level, the 
Model Menu, the Dynamica model and the Dynex Model Interface. 




DYNAMICA MODEL DYNEX MODEL INTERFACE 



Run Simulation 

Store and Print Results 

View Results and Print Graphs 



4 



Variable Manipulation 



Figure 4-1. Overview of System Architecture 

The heart of the system is the Dynamica model. The 
Dynamica model, written in Professional Dynamo, allows the 
dynamic processing of variables from management-type 
functions and software production type activities. The Model 
menu allows the inexperienced modeler, access to the Dynamica 
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model directly to perform the numerous model functions 
available through Professional Dynamo (e.g., run simulations, 
store and plot statistics and to view simulation results). 

The Dynex Model Interface is unique in that it allows the 
user to interact with the Dynamica model (e.g., changing the 
values of variables and constants). The Model Menu accesses 
the Dynamica model via the Dynex Model Interface to allow the 
user to manipulate variable values within the Dynamica model. 

B. MODEL MENU 

The Model Menu is a shell which allows the logical 
organization by function, of 24 separate batch files. 

The Model Menu utilizes the nesting of submenus to enhance 
the functional organization of the menu. For example, if # 2 
Help Facilities is selected from the main Model Menu, the 
user is presented a submenu of three help related topics. 
Selection of # 3, Professional Dynamo Help, from this second 
menu presents the user with a submenu of eight Professional 
Dynamo Help topics to choose from. 

The Model Menu has five functionally related submenus. 
Introduction to the Model Menu, Help Facilities, Professional 
Dynamo Help, To Store and Print Results, and Plotting 
Results. Typing the number of any menu selection initiates a 
batch file which either performs a function (e.g., selection 
of # 2, Run Simulation, runs a model simulation ) or produces 
a submenu with additional choices. The 24 batch files are 
separate from the menu shell and are easily modified. The 
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submenus are part of the shell structure as listed in 
Appendix B and require the use of the EXECMAKE function of 
EBL to be modified. 

The name of the batch file which initiates the menu 
program is menu.bat. It performs the following functions: 

(1) turn echo off, (2) enters the DOS command graphics, (3) 
loads the BATALLF command file from EBL and (4) brings the 
main menu, titled MODEL MENU to the display. The BATALLF 
command file contains the Extended Batch Language program and 
all external EBL function commands [Ref. 8 : pp . 2-5], 

The Model Menu was written using the EXECMAKE function of 
Extended Batch Language, Version 3 [Ref. 8:p. 10]. EBL is a 

high level, command programming language which can be used in 
replacement of, or in conjunction with DOS batch files [Ref. 
9:p. 2]. EBL provides enhanced string handling 
character istics, superior control structures and screen 
control relative to standard DOS batch files [Ref. 9 : pp . 2- 

3] . 

The 24 batch files have been divided into three 
categories based on their functions in the Model Menu. They 
are discussed separately in the following three sections. A 
program listing of the batch files has been provided in 
Appendix C. 

1 . Batch File Explanations of Model Functions 

Fourteen of the twenty-four batch files called by 
the Model Menu are script files which provide the user 
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instructions or background information on the use of the 
Dynamica model and the user interface Figure 4-2. All of 
these script files, except for Professional Dynamo Help were 
created for this thesis using the advanced string handling 
characteristics of EBL. 

Figure 4-2 depicts the batch files that provide the 
explanation screens of menu options discussed in Chapter III. 



Introduction to the 
Model Menu 

Purpose of the Model 

Menu Purpose.bat 

Hardware /Software 

Requirements Hardwar.bat 

Suggestions for 

Using the Menu Suggest.bat 

Figure 4-2. Batch File Explanations of Model Menu Functions 
2 . Help Batch Files 

Professional Dynamo Help provides the user access to 
the help facilities provided within Professional Dynamo 
[Ref. 10]. These help facilities provide valuable 
information to the experienced model builder on the operation 
of the model. The batch files which access the eight 
separate Professional Dynamo help files are listed in Figure 
4-3. Users view these eight separate help files via the 
public domain software program, List.com. List.com allows 
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the user to page or scroll through the files, forwards or 
backwards, after they have been accessed from the Model Menu 
[Ref. 11]. 



MODEL MENU 


BATCH FILES 


Professional Dynamo 
Help 

Overview of PD Help 


PD. bat 


Dynex Help 


Dynex . bat 


Editor Help 


Editor . bat 


Simulation Help 


Simhelp. bat 


Tools Help 


Tools . bat 


Translator Help 


Transhel . bat 


Utilities Help 


Ut ilhel . bat 


View Help 


V iewhel . bat 


To Store and Print Results 
Plotting Results 
Over of Plotting 
Funci tons 


Overview . bat 


Help Facilities 
Over of Help 
Facilities 


Over . bat 


Online Model Help 
Information 


Help . bat 



Figure 4-3. Help Batch File 

3 . Batch Files for Printing Simulation Results 
As a convenience to the user, a file printing 
facility was cheated and included in the menu system to allow 
the user to produce hard copies of simulation results with an 
attached printer. The print.bat file see Figure 4-4 was 
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written using DOS and EBL commands. A public domain software 
program, SDIR26.com, is utilized in the batch file to produce 
the directory display the user views [Ref. 12]. 



MODEL MENU 



PRIMTIMG FILES 



Printing Your 
Results 



Pr int . bat 



prints files using 
DOS commands 



Figure 4-4. Model Menu - Printing Files 



C. THE DYNAMICA MODEL 

The Dynamica model, was originally written by Dr. Tarek 
K. Abdel-Hamid, while at the Massachusetts Institute of 
Technology [Ref. 131. The Model Menu accesses the Dynamica 
model directly via the seven separate batch files listed in 
Figure 4-5, or indirectly via the Dynex Model Interface. 

The seven batch files shown in Figure 4-5, call commands 
within the Dynamica model. The Dynex Model Interface is 
explained in part D. of this chapter. 

Explanations of the Dynamica model commands shown in 
Figure 4-5, which would be useful to the experienced model 
builder, can be found in the Professional Dynamo Help 
screens . 
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MODEL MENU 



PROFESSIONAL DYNAMO 

COMMANDS 



Run Simulations Runsi 

Store and Print 
Results 



Storing Statistics 


Simul 


Plotting Results 




Functions 




Plot 1 


Plotl 


Plot 2 


Plot2 


Plot 3 


Plots 


Plot 4 


Plot4 



m . bat 


sml t 


; project 


-go 


at . bat 


pro j 


ect stats 


. bat 


rep 


project 


plotl 


. bat 


rep 


project 


plot2 


. bat 


rep 


project 


plo t3 


. bat 


rep 


project 


plot4 



View Results and Print 

Graphs Viewsim.bat view project. rsl 



Figure 4-5. Model Menu - Dynamica Model 

D. THE DYNEX MODEL INTERFACE 

The Dynex Model Interface, was written for this thesis in 
Dynex, the high level model interface language of 
Professional Dynamo. Dynex was specifically designed to 
allow the experienced model builer to create an environment 
for model operation specifically suited for a certain skill 
level of user. Mose often, the model builder creates a 
"game" type of format, which allows the model to be used by 
inexperienced modelers. Dynex allows the model builder to 
set up files which execute Professional Dynamo commands, 
transparently to the user [Ref. 10:p. 181]. 

When Dynex files are invoked, model functions are 
performed automatically for the user. The experienced model 
builder can use Dynex to make a model available for users in 



57 



a structured and easily understandable framework [Ref. 10 :p. 
181]. He can provide information on model operation to a 
user, at a level commensurate with the user's abilities and 
experience level. 

Dynex is unique in that it allows the user to access the 
variables within a simulation model written in Professional 
Dynamo. In contrast, the batch files written for the user 
interface, perform "house-keeping details", and execute 
numerous commands for the convenience of the user. 

The Model Menu system accesses Dynex Model Interface via 
the single batch file shown in Figure 4-6. 



tiOEEL MENU DYNEX MODEL INTERFACE 

Variable Variabl.bat project dynex 

Manipulation 



Figure 4-6. Model Menu - Dynex Model Interface 



After the user has completed using the Dynex Model 
Interface, he/she will be returned automatically to the main 
Model Menu. 
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V. CONCLUSIONS 



A. ACCOMPLISHMENTS 

The primary objective of this thesis was the development 
of a user interface for the Dynamica Model of Software 
Project Management which would: (1) make the Dynamica model 

easier to use, (2) improve the model's facilities for 
accessing, storing and reviewing simulation results and (3) 
improve the current method of variable manipulation. 

A menu system was created to outline and provide easy 
access to the major functions of the Dynamica model. A help 
system was provided along with numerous script files 
explaining model functions. Facilities were provided to 
allow the user to store, plot or print simulation results. 
Viewing simulation results was also made easier. Most of 
these improvements were done with the use of DOS and EBL 
batch files in conjunction with the model menu. The user is 
able to select a desired function using the Model Menu system 
and have the batch files perform the low level work. 

A model interface was programmed in Dynex to control and 
improve the access and manipulation of varaibles in the 
Dynamica model . 

B. LESSONS LEARNED 

The user interface for the Dynamica model was designed 
by an iterative process of prototyping and testing. This 
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method of design was successful but time consuming. The 
testing of the prototype systems often revealed flaws that 
otherwise were not readily apparent. For example, early 
prototypes did not provide the user with an adequate amount 
of feedback after menu selections. It was recognized that 
periods of "dead time" on the users display, while files were 
loaded or DOS commands were being executed, gave the 
impression to the user that the interface was not functioning 
properly. Since these commands and DOS functions could r.'t 
be sped up, the dead periods were replaced with screens 
which provided the user assurances that the model was 
functioning normally. 

Secondly, to offset the time consuming process of 
prototyping a system design of this nature, the designer is 
best served by creating and experimenting with only the shell 
of the proposed system. Only after the design of the shell 
has met with approval via testing should the designer begin 
writing the modules called by the shell. 

Originally, the 24 batch files were part of the Model 
Menu shell created with the EXECMAKE facility of EBL. Editing 
of any batch file required that the Model Menu shell be 
similarly adjusted, a time consuming process. This editing 
problem was resolved by having the Model Menu contain only 
calls to the batch files. The 24 separate batch files can 
now be edited individually. 
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Lastly, early prototypes of the Dynex Model Interface 
were found to include more information for the user then was 
suitable for that format. Much of this information, belonged 
more appropriately in a user or reference manual format. 

C. FUTURE DIRECTION 

There are many areas available for future research. These 
areas fall under two general categories, the refining of the 
current interface, and expanding the capabilities of the 
inter face . 

There are many areas in the current interface that need 
refinement or expanding. Keeping in mind that the major goal 
of the Dynamica model is for users to develope a better 
understanding of the dynamic behavior of software project 
variables, improved methods of storing and analyzing the 
results of numerous simulations are needed. One suggestion 
is to use the Professional Dynamo, Report Generator 
facilities to plot the results of variables from multiple 
simulations. Another is to provide the user the capability 
to save plots or graphs in files of the user's choosing. 

The current system also needs the development of a more 
complete user's manual. This user's manual should provide 
detailed information on the Dynamica model as well as the 
design of the user interface. Its goal should be to help 
users learn how to manipulate the Dynamica model to best suit 
their own needs. To do this would require an extensive. 
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detailed manual with numerous examples. It would require the 
compilation of reference information from Professional 
Dynamo, EBL, and the Dynamica model. 

User comments should also be collected and studied to 
determine problem areas of the interface in its current form. 
Users should be queried as to what other variables or 
capabilities they would like made available. 

Dynex also has the capability for the creation of 
extensira inline help facilities. These help facilities are 
available when the user is operating within the Dynex model 
interface. Suggested topic areas for this help would include 
inputing variable values (for both single value variables and 
table variables), saving and printing simulation results 
(plotting, graphs and report generation) and the explanation 
of Dynex error codes. 

Finally, a more ambitious suggestion would be to include 
the Intermediate Constructive Cost Model (COCOMO) in the user 
interface [Ref. 14:p. 58]. COCOMO is a generic name for a 
hiearchy of software cost-estimation models. The intermediate 
level of COCOMO uses 15 cost drivers or predictors to 
estimate software development effort. Research for this 
thesis, would suggest two possible implementation schemes. 
First and most preferable, would be to incorporate the COCOMO 
variables and their equations into the Dynamica model using 
Professional Dynamo. These variables could then be accessed 
via the Dynex Model Interface. A second option would be to 
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write a C or BASIC program which would accept variable values 
and perform the required COCOMO calculations. This program 
would be called by the Model Menu, via a DOS batch file. 

This DOS batch file would also return the variables 
calculated by COCOMO to the Dynamica model. The first option 
would be preferred for its speed, ease of operation, and the 
increased flexibility provided the system designer and the 
user. Using eigher option mentioned, would allow the user to 
refine a basic COCOMO development effort estimate. 

Dynex allows the use of arithmetic expressions of 
parameter names and numbers within the display of text. An 
experienced model builder could therefore create a "learning 
game" where user predictions could be matched against the 
quantitatively produced COCOMO estimations. The user could 
then select the values of his choice for use in the Dynamica 
model, and be provided rapid feedback, on the consequences by 
running a model simulation. 
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APPENDIX A 



BATCH FILES PROGRAM LISTING 



BAT CLS 
ECHO OFF 

BAT REM FILE NAME: VARIABL.BAT 

BAT BEGTYPE 

\0A 



THE MODEL IS BEING LOADED ! 



END 

BAT TYPE TIME( C ) 
BAT TYPE DATE( ) 
DYNEX PROJECT 



BAT CLS 
ECHO OFF 

BAT REM FILE NAME: 
BAT CLS 
BAT BEGTYPE 
\0A 



RUNSIM.BAT 



THE MODEL IS BEING PREPARED FOR A SIMULATION 



END 

BAT TYPE TIME( C ) 
BAT TYPE DATE( ) 
SMLT PROJECT -GO = 
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VIEWSIM.BAT 



BAT CLS 
ECHO OFF 

BAT REM FILE NAME: 
BAT CLS 
BAT BEGTYPE 
\0A 



YOUR RESULTS ARE BEING PREPARED FOR VIEWING ! 



IF YOU HAVE AN EGA GRAPHICS CARD TYPE (y) 
FOLLOWED BY ENTER. 

IF YOU DO NOT HAVE AN EGA CARD TYPE (n) 
FOLLOWED BY ENTER. 



END 

BAT INKEY %0 

BAT IF Y = %0 THEN GOTO EGA 
BAT ELSE GOTO OTHER 



:EGA 

VIEW PROJECT. RSL -PLM 6 
BAT CLS 
BAT EXIT 

: OTHER 

VIEW PROJECT. RSL 
BAT EXIT 
ECHO OFF 

BAT REM FILE NAME: PURPOSE.BAT 

WELCOME 

WELCOME TO THE MODEL MENU ! JUST BRIEFLY, LETS 
DISCUSS WHAT THE MODEL MENU IS AND WHAT IT ISN'T, TO 
HOPEFULLY AVOID ANY CONFUSION AS YOU BEGIN TO FAMILAIARIZE 
YOURSELF WITH THE DYNAMICA MODEL OF SOFTWARE PROJECT 
MANAGEMENT. 

I. COMPONENTS OF THE MODEL MENU 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
IS A SOPHISTICATED SIMULATION MODEL WRITTEN BY DR. TAREK 
K. ABDEL-HAMID, IN PROFESSIONAL DYNAMO. PROFESSIONAL 
DYNAMO (ABBREVIATED PD ) IS A HIGH LEVEL SIMULATION 
LANGUAGE CREATED BY PUGH - ROBERTS ASSOCIATES, INC. 

ACCESS TO THE SYSTEM DYNAMICS MODEL OF SOFTWARE 
MANAGEMENT IS PROVIDED BY THE MODEL MENU. THE MODEL 
MENU , WRITTEN USING EXTENDED BATCH LANGUAGE, DOS 
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COMMANDS, SEVERAL PUBLIC DOMAIN BATCH FILE UTILITIES AND 
THE PD INTERFACE LANGUAGE DYNEX, HAS BEEN DESIGNED TO 
EASE AND SPEED USER ACCESS TO THE MODEL AND AID IN 
THE MANIPULATION OF SIMULATION RESULTS. 

HIT ANY KEY TO CONTINUE. 

END 

BAT INKEY 
BAT CLS 
ECHO OFF 

BAT REM FILE NAME: HARDWAR.BAT 

BAT CLS 
BAT BEGTYPE 

\0A****************************************************** 

HARDWARE AND SOFTWARE REQUIREMENTS. 



HARDWARE : 

THE MODEL REQUIRES AN IBM OR IBM COMPATIBLE XT/AT 
MICROCOMPUTER, WITH 640 K OF RAM AND A HARD DISK OR 
1.2 MEG FLOPPY. 

EXECUTION OF MODEL SIMULATIONS IS A VERY 
NUMERICALLY INTENSIVE OPERATION. THE EXECUTION SPEED 
INCREASES TREMENDOUSLY WITH THE USE OF A MATH 
CO-PROCESSOR CHIP. 

THE MODEL PROVIDES SUPPORT FOR THE MOST COMMON 
GRAPHIC DISPLAY MODES, MDA, CGA AND EGA. THE MODEL'S 
USE OF COLOR IS DESIGNED TO ENHANCE USABILITY BUT IS 
NOT A REQUIREMENT. 

SOFTWARE: 

THE MODEL REQUIRES MS OR PC DOS 2 . xx OR GREATER. 
CHECK TO MAKE SURE ALL THE FILES LISTED ON THE SYSTEM 
DISK ARE PRESENT IF ANY PROBLEMS ARISE. 

HIT ANY KEY TO CONTINUE 



END 

BAT INKEY 
BAT CLS 
ECHO OFF 

BAT REM FILE NAME: SUGGEST.BAT 

BAT CLS 
BAT BEGTYPE 
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SUGGESTIONS ? 



THE FIRST RECCOMENDED ORDER OF BUSINESS FOR ALL 
NEW USERS IS TO FAMILIARIZE YOUR SELF WITH THE MODEL MENU. 
TAKE A FEW MOMENTS AND EXPLORE ALL THE MENU SELECTIONS. 

THERE IS NO NEED TO ENTER DATA OR RESPOND TO ANY OF THE 
QUERIES, JUST SCAN THE SCREENS AND HIT ENTER OR ANY KEY AS 
PROMPTED TO CONTINUE. THIS WHOLE PROCESS SHOULD ONLY TAKE 
YOU 10 MINUTES OR SO. WRITE DOWN ANY QUESTIONS THAT COME TO 
MIND AS YOU SCAN. 



IF YOUR QUESTIONS ARE BEGINING TO DEAL MORE WITH HOW 
AM I GOING TO USE DYNAMICA TO BETTER UNDERSTAND SOFTWARE 
PROJECT MANGEMENT AND HOW CAN I CUSTOMIZE IT, IT IS TIME FOR 
YOU TO GO TO THE NEXT STEP. 



HIT ANY KEY TO CONTINUE 

END 

BAT INKEY 
BAT CLS 
BAT BEGTYPE 

ic'k'k'kicic'kieicicif'kicicieicicic'kicicicicicic'kicicicicieicicic'kicicit'kitic'kiciciricirieiciticificic'kit'k 



REVIEW THE MODEL VARIABLE 
DEFINITIONS 

'k'k:k:kicicici(icicicicicicicieici(ic'^ic'kic'k'kic'icicicic'ki(i(ieicic-k'kic'k'k-k-kicic'k'ki(iiiiciiiie-kicici(ic 



IF YOU PLAN TO USE THE MODEL TO SIMULATE A 
PARTICULAR SOFTWARE PROJECT THAT YOU HAVE DATA ON, THE 
MODEL SHOULD BE CUSTOMIZED TO REFLECT THAT PROJECT. YOUR 
FIRST STEP TOWARDS THAT GOAL IS TO DISCOVER WHAT VARIABLES 
ARE AVAILABLE IN DYNAMICA AND WHAT THEY REPRESENT IN THE 
MODEL. YOU AND THE MODEL HAVE TO UNDERSTAND ONE ANOTHER. 

FOR EXAMPLE, IF HIRING DELAY IS A VARIABLE YOU WISH TO 
ADJUST, YOU MUST UNDERSTAND HOW IT IS DEFINED BY THE MODEL. 



HIT ANY KEY TO CONTINUE 

END 

BAT INKEY 
BAT CLS 
BAT BEGTYPE 



NOTE: 

THE QUANTITATIVE TYPES READING THIS ARE ALREADY 
SAYING TO THEMSELVES, WHY DON'T THEY GIVE US THE EQUATIONS 
THE MODEL USES, THEN I CAN REALLY FIGURE OUT WHAT'S GOING ON. 
UNFORTUNATELY, TO DO THAT WOULD REQUIRE THAT YOU BECOME 
FAMILIAR WITH FAR MORE VARIABLES THEN THE 20 PRIMARY 
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VARIABLES ADJUSTABLE VIA THE MENU, LIKE ROUGHLY 150 MORE, AND 
BECAUSE THIS IS A DYNAMIC MODEL THE RELATIONSHIPS VARY 
THROUGHOUT THE LIFE OF THE SOFTWARE PROJECT. THATS WHY 
COMPUTER MODELS ARE SO VALUABLE. IN A FEW MINUTES TIME, THE 
MODEL VARIABLES CAN BE ADJUSTED AS YOU SEE FIT, A SIMULATION 
CAN BE RUN WITH THOSE VARIABLES AND RESULTS STORED ON OVER 
^QUANTITATIVE MEASURES OF PROJECT PERFORMANCE. 



HIT ANY KEY TO CONTINUE 

END 

BAT INKEY 
BAT CLS 
ECHO OFF 

BAT REM FILE NAME; OVER.BAT 

FAT CLS 
BAT BEGTYPE 

OVERVIEW OF AVAILABLE HELP FACILITIES 



THERE ARE TWO TYPES OF HELP AVAILABLE TO THE USER: (1) 
ONLINE MODEL HELP AND (2) PROFESSIONAL DYNAMO HELP. 

ONLINE MODEL HELP IS AVAILABLE TO THE USER WHEN 
UTILIZING SELECTION # 3 OF THE MAIN MENU - VARIABLE 
MANIPULATION. AT ANY PROMPT, THE USER NEED ONLY TO TYPE 
(H)ELP (H)ELP TO GET A LIST OF AVAILABLE HELP CATEGORIES. 



PROFESSIONAL DYNAMO HELP PROVIDES THE MORE EXPERIENCED 
MODEL USER ACCESS TO 8 PD HELP TOPICS. 



HIT ANY KEY TO CONTINUE ! 

END 

BAT INKEY 
BAT CLS 



ECHO OFF 

BAT REM FILE NAME: HELP.BAT 

BAT CLS 
BAT BEGTYPE 

\0A********************************************************** 

ONLINE MODEL HELP INFORMATION 
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THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
HAS THE CAPABILITY FOR EXTENSIVE, USER DEFINED, EASILY 
MODIFIABLE HELP. ACCESS TO THIS HELP IS AVAILABLE WHILE 
UTILIZING MAIN MENU SELECTION # 3, MODEL & VARAIBLE 
MANIPULATION. THIS HELP CAPABILITY IS A FEATURE OF 
PROFESSIONAL DYNAMO, DESIGNED BY PUGH-ROBERTS ASSOCIATES, 
INC. 



TO ACCESS AN EXAMPLE OF THIS HELP, THE USER SIMPLY 
TYPES (H)ELP (H)ELP FOLLOWED BY ENTER. 

HIT ANY KEY TO CONTINUE 



END 

BAT INKEY 
BAT CLS 



ECHO OFF 

BAT REM FILE NAME: SIMULAT.BAT 

BAT CLS 
BAT BEGTYPE 
\0A 

YOUR RESULTS ARE BEING STORED IN THE PROPER FORMAT ! 



END 

BAT TYPE TIME( C ) 
BAT TYPE DATE() 

REP PROJECT STATS 

BAT CLS 
BAT BEGTYPE 
\0A 



PLEASE ENTER THE FILE NAME YOU DESIRE FOR THIS REPORT. 
IT IS SUGGESTED THAT YOU NAME YOUR FILES IN A MANNER 
WHICH WILL ALLOW THE MAXIMUM BENEFITS OF THE DOS 
WILDCARD 

( * ) FEATURE WHEN MANIPULATING YOUR FILES. 

EXAMPLE: (PROJECT.*) 
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NOTE: 



CHANGES MADE TO VARIABLES ARE STORED IN THE 
FILE. FOR EXAMPLE IF HIRING DELAY WAS CHANGED 
FROM 30 TO 40, THAT INFORMATION WOULD BE STORED 
AT THE END OF THE REPORT. 



END 

BAT READ %0 
BAT CLS 
BAT BEGTYPE 
\0A 

ENTER THE FULL PATH NAME OF THE DIRECTORY WHERE YOU 
WOULD LIKE THE RESULTS STORED. 



END 

BAT READ %1 
REN PROJECT. OUT %0 
COPY %0 + PROJECT. WAS 
COPY %0 %1 
ECHO OFF 

BAT REM FILE NAME: PRINT.BAT 

BAT CLS 

D /6 

BAT TYPE HIT ANY KEY TO CONTINUE ! 

BAT INKEY 
: AGAIN 
BAT CLS 
BAT BEGTYPE 



\0A 

PLEASE ENTER THE FULL NAME OF THE FILE YOU WOULD LIKE 
PRINTED. YOU MAY USE DOS WILDCARD ( * ) SYMBOLS FOR 
PRINTING MORE THEN ONE FILE AT A TIME. 

OTHERWISE, PLEASE TYPE (Q) TO QUIT. 

EXAMPLE: (MONDAY.*) 

END 



BAT read %2 

BAT IF %2 = Q THEN EXIT 
BAT ELSE 

COPY %2 PRN 
BAT GOTO : AGAIN 
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ECHO OFF 
BAT CLS 

BAT REM FILE NAME: OVERVIE.BAT 

BAT BEGTYPE 



ECHO OFF 

BAT REM FILE NAME: PLOTl.BAT 

BAT CLS 
BAT BEGTYPE 

\0A****************************^*****^***************^*****^ 

PLOT 1 

PLOT 1 GRAPHS THE FOLLOWING VARIABLES: 



SCHCDT ESTIMATED SCHEDULE IN DAYS 

PJBSZ PERCEIVED PROJECT SIZE IN TASKS 

JBSZMD ESTIMATED PROJECT COST IN MAN-DAYS 

TOTWF TOTAL WORKFORCE PEOPLE 

CUMMD CUMULATIVE MAN-DAYS EXPENDED 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



END 






BAT 


INKEY 


%0 


BAT 


CLS 




BAT 


IF Y 


= %0 THEN GOTO 


BAT 


ELSE 


GOTO OTHER 



:EGA 

REP PROJECT PLOTl -PLM 6 
BAT GOTO -NEXT 
: OTHER 

REP PROJECT PLOTl 
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BAT -NEXT 
BAT CLS 
BAT BEGTifPE 
\0A 



IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHERWISE TYPE (Q)UIT TO 
RETURN TO THE MENU. 



END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 

BAT ELSE GOTO NAME 

:NAME 

REN PLOT l.OUT 

: LEAVE 
BAT EXIT 
ECHO OFF 

BAT REM FILE NAME: PLOT2.BAT 

BAT CLS 



BAT BEGTYPE 



PLOT 2 



FIRST, A QUICK REVIEW OF THE VARIABLES BEING 

PLOTTED: 



CMTKDV CUMULATIVE TASKS DEVELOPED 

CUMTKT CUMULATIVE TASKS TESTED 

CUMMD CUMULATIVE MAN-DAYS EXPENDED 

PJBSZ PERCEIVED PROJECT SIZE IN TASKS 

PDEVRC ESTIMATED % DEVELOPMENT COMPLETE 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



END 

BAT INKEY %0 
BAT CLS 

BAT IF Y = %0 THEN GOTO EGA 
BAT ELSE GOTO OTHER 



:EGA 

REP PROJECT PLOT2 -PLM 6 
BAT GOTO -NEXT 
: OTHER 

REP PROJECT PLOT2 
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BAT -NEXT 
BAT CLS 
BAT BEGTYPE 
\0A 



IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHER WISE TYPE (Q) TO RETURN 
TO THE MENU. 

END 

BAT READ 

BAT IF Q = %1 THEN GOTO LEAVE 

BAT ELSE GOTO NAME 

:NAME 

REN PL0T2.0UT %1 



: LEAVE 
BAT EXIT 
ECHO OFF 

BAT REM FILE NAME: PLOT3.BAT 

BAT CLS 



BAT BEGTYPE 

\0A******************************************************** 

PLOT 3 

*********************************************************** 
FIRST, A QUICK REVIEW OF THE VARIABLES BEING 

PLOTTED: 



TOTWF TOTAL WORKFORCE 

FRWFEX .... FRACTION OF WORKFORCE THAT IS EXPERIENCED 

SDVPRD PRODUCTIVITY 

COMMOH COMMUNICATION OVERHEAD 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



END 

BAT INKEY %0 
BAT CLS 

BAT IF Y = %0 THEN GOTO EGA 
BAT ELSE GOTO OTHER 



:EGA 

REP PROJECT PLOT3 -PLM 6 
BAT GOTO -NEXT 
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: OTHER 

REP PROJECT PLOTS 

BAT -NEXT 
BAT CLS 
BAT BEGTYPE 
\0A 



IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHER WISE TYPE (Q) TO RETURN 
TO THE MENU. 

END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 

BAT ELSE GOTO NAME 

:NAME 

REN PLOTS. OUT %1 



: LEAVE 
BAT EXIT 
ECHO OFF 

BAT REM FILE NAME: PLOT4.BAT 

BAT CLS 



BAT BEGTYPE 

PLOT 4 



FIRST, A QUICK REVIEW OF THE VARIABLES BEING 

PLOTTED: 



AFMPDJ .... ACTUAL FRACTION OF A MAN-DAY ON PROJECT 



JBSZMD PERCEIVED TOTAL JOB SIZE IN MAN-DAYS 

PJBSZ PERCEIVED JOB SIZE IN TASKS 

PMDSHR PERCEIVED SHORTAGE IN MAN-DAYS 



IF YOU HAVE AN EGA CARD TYPE (Y)ES IF NOT TYPE (N)0. 



END 

BAT INKEY %0 



BAT CLS 

BAT IF Y = %0 THEN GOTO EGA 
BAT ELSE GOTO OTHER 
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:EGA 

REP PROJECT PLOT4 -PLM 6 
BAT GOTO -NEXT 

: OTHER 

REP PROJECT PLOT4 

BAT -NEXT 
BAT CLS 
BAT BEGTYPE 
\0A 



IF YOU WOULD LIKE TO SAVE THE PLOT PLEASE ENTER A 
DOS LEGAL FILE NAME, OTHER WISE TYPE (Q) TO RETURN 
TO THE MENU. 



END 

BAT READ %1 

BAT IF Q = %1 THEN GOTO LEAVE 

BAT ELSE GOTO NAME 

:NAME 

REN PL0T4.0UT %1 



: LEAVE 
BAT EXIT 
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APPENDIX B 



MODEL MENU SHELL PROGRAM LISTING 



ECHO OFF 

BATALLF.COM 

GRAPHICS 

bat /N /p /s * . . . Loading ... MODEL MENU 
Call -topi 
Exit 



-top goto -top%A 



* Remove the following data ONLY if further changes will not* 

* be made * 



'•''EMS'-'' 1.40 

EBL Extended Variables - 
Current variable contents 



Version 1.03 
is : 



&C5 = 17 

&DESCRIP81 
&K81 = H 

&DESCRIP91 
&K91 = I 

ScDESCRIPlOl 
ScKlOl = J 
ScDESCRIPlll 
ScKlll = K 
&DESCRIP121 
&K121 = L 

&DESCRIP131 
&K131 = M 

&DESCRIP141 
&K141 = N 

&DESCRIP151 
&K151 = 0 

&DESCRIP161 
&K161 = P 

&DESCRIP171 
&K171 = Q 

&DESCRIP181 
&K181 = R 

&DESCRIP191 
&K191 = S 

&DESCRIP201 
&K201 = T 

&C1 = IF 

&C2 = lA 
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&C3 = lA 

&C4 = ID 

&NAME1 = MODEL MENU 

ScTITLEl = FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT 

MANAGEMENT. 

ScKll = 1 

ScDESCRIPll = INTRODUCTION TO THE MODEL MENU 

ScCMDll = '•SUB-MENU-2 

&NAME2 = INTRODUCTION TO THE MODEL MENU 
&DESCRIP42 
&K42 = D 

&DESCRIP52 
&K52 = E 

&DESCRIP62 
&K62 = F 

&DESCRIP72 
&K72 = G 

&DESCRIP82 
&K82 = H 

&DESCRIP92 
&K92 = I 

&DESCRIP102 
&K102 = J 

&DESCRIP112 
ScK112 = K 
&DESCRIP122 
&K122 = L 

&DESCRIP132 
&K132 = M 

&DESCRIP142 
&K142 = N 

&DESCRIP152 
&K152 = 0 

ScDESCRIP162 
&K162 = P 

&DESCRIP172 
&K172 = Q 

&DESCRIP182 
&K182 = R 

S=DESCRIP192 
&K192 = S 

S=DESCRIP202 
&K202 = T 

&K12 = 1 

&DESCRIP12 
&CMD12 = 22187 

&K22 = 2 

&DESCRIP22 
&CMD22 = 22226 
&KSUM2 =123 
&K32 = 3 

&DESCRIP32 



= PURPOSE OF THE MODEL MENU 



= HARDWARE/SOFTWARE REQUIREMENTS 



2 

D 



EFGHIJKLMNOPQRST 



= SUGGESTIONS FOR USING THE MENU 
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&TITLE2 = THE FOLLOWING MENU PROVIDES INRTODUCTORY 
INFORMATION TO NEW USERS. 

&K21 = 2 

&DESCRIP21 = HELP FACILITIES 

ScCMD21 = -SUB-MENU-3 

&NAME3 = HELP FACILITIES 

ScDESCRIP43 

S=K43 = D 

&DESCRIP53 

&K53 = E 

S=DESCRIP63 

&K63 = F 

ScDESCRIP73 

&K73 = G 

ScDESCRIP83 

&K83 = H 

&DESCRIP93 

&K93 = I 

&DESCRIP103 

6=K103 = J 

&DESCRIP113 

&K113 = K 

6=DESCRIP123 

&K123 = L 

&DESCRIP133 

&K133 = M 

&DESCRIP143 

&K143 = N 

&DESCRIP153 

&K153 = 0 

&DESCRIP163 

&K163 = P 

6cDESCRIP173 

&K173 = Q 

&DESCRIP183 

S=K183 = R 

&DESCRIP193 

&K193 = S 

&DESCRIP203 

&K203 = T 

&K13 = 1 

&DESCRIP13 = OVERVIEW OF HELP FACILITIES 

&CMD13 = 22287 2 

&TITLE3 = INTRODUCTION TO DYNAMICA AND PROFESSIONAL DYNAMO 
HELP FACILITIES. 

&K23 = 2 

&DESCRIP23 
&CMD23 = 22323 
&KSUM3 =123 
&K33 = 3 

&DESCRIP33 



= ONLINE MODEL HELP INFORMATION 
2 

DEFGHIJKLMNOPQRST 



= PROFESSIONAL DYNAMO HELP 



&CMD33 = -SUB-MENU-4 
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&NAME4 = PROFESSIONAL DYNAMO HELP 

&DESCRIP94 

&K94 = I 

&DESCRIP104 

&K104 = J 

&DESCRIP114 

&K114 = K 

&DESCRIP124 

&K124 = L 

&DESCRIP134 

&K134 = M 

&DESCRIP144 

&K144 = N 

&DESCRIP154 

&K154 = 0 

&DESCRIP164 

&K164 = P 

&DESCRIP174 

&K174 = Q 

&DESCRIP184 

&K184 = R 

&DESCRIP194 

&K194 = S 

&DESCRIP204 

&K204 = T 

&TITLE4 = THE FOLLOWING MENU PROVIDES ACCESS TO PD HELP 
FACILITIES. 

&K14 = 1 



&DESCRIP14 


= 


OVERVIEW OF PD HELP 


&CMD14 = 22359 


2 




&K24 = 2 

&DESCRIP24 


_ 


DYNEX HELP 


&CMD24 = 22377 


2 




&K34 = 3 

&DESCRIP34 


— 


EDITOR HELP 


&CMD34 = 22398 


2 




&K44 = 4 

&DESCRIP44 


— 


SIMULATION HELP 


&CMD44 = 22418 


2 




&K54 = 5 

&DESCRIP54 


_ 


TOOLS HELP 


&CMD54 = 22438 


2 




&K64 = 6 

&DESCRIP64 


_ 


TRANSLATOR HELP 


&CMD64 = 22459 


2 




&K74 = 7 

&DESCRIP74 


_ 


UTILITIES HELP 


&CMD74 = 22479 


2 




&KSUM4 =123 


4 


5678IJKLMNOPQRST 


&K84 = 8 

&DESCRIP84 


_ 


VIEW HELP 


&CMD84 = 22500 


2 
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VARIABLE MANIPULATION 



&K31 = 3 

&DESCRIP31 
&CMD31 = 22520 
&K41 = 4 

&DESCRIP41 
&CMD41 = 22559 
&K61 = 6 

&DESCRIP61 
&CMD61 = 22597 
&K71 = 7 

&DESCRIP71 
&CMD71 = 22636 
&KSUM1 =123 
&K51 = 5 

&DESCRIP51 
&CMD51 = "SUB-MENU-B 
&NAME5 = TO STORE AND 
&DESCRIP45 
&K45 = D 

&DESCRIP55 
&K55 = E 

&DESCRIP65 
&K65 = F 

&DESCRIP75 
&K75 = G 

&DESCRIP85 
&K85 = H 

&DE3CRIP95 
&K95 = I 

&DESCRIP105 
&K105 = J 

ficDESCRIP115 
&K115 = K 

&DESCRIP125 
&K125 = L 

&DESCRIP135 
&K135 = M 

&DESCRIP145 
S=K145 = N 

&DESCRIP155 
&K155 = 0 

&DESCRIP165 
&K165 = P 

&DESCRIP175 
&K175 = Q 

&DESCRIP185 
&K185 = R 

&DESCRIP195 
&K195 = S 

&DESCRIP205 
&K205 = T 

&TITLE5 = THIS 



= RUN SIMULATIONS 



= VIEW RESULTS AND PRINT GRAPHS 



= EXIT TO DOS 
2 

4567HIJKLMNOPQRST 



= TO STORE AND PRINT RESULTS 



PRINT RESULTS 



MENU ALLOWS THE USER TO STORE AND PRINT 



80 



SIMULATION RESULTS. 



&K15 



1 



&DESCRIP15 
&CMD16 = 22655 2 



STORING STATISTICS 



&K25 

&DESCRIP25 



2 



PLOTTING RESULTS 



&KSUM5 =123DEFGHIJKLMNOPQRST 
&K35 = 3 



&CMD35 = 22730 2 

&CMD32 = 22767 2 

&CMD25 = -SUB-MENU-6 

&NAME6 = PLOTTING RESULTS 

&DESCRIP66 

&K66 = F 

&DESCRIP76 

&K76 = G 

ScDESCRIP86 

&K86 = H 

&DESCRIP96 

&K96 = I 

&DESCRIP106 

&K106 = J 

&DESCRIP116 

&K116 = K 

&DESCRIP126 

&K126 = L 

&DESCRIP136 

&K136 = M 

&DESCRIP146 

&K146 = N 

&DESCRIP156 

&K156 = 0 

&DESCRIP166 

&K166 = P 

S=DESCRIP176 

&K176 = Q 

&DESCRIP186 

&K186 = R 

&DESCRIP196 

&K196 = S 

&DESCRIP206 

&K206 = T 

&K16 = 1 

&DESCRIP16 = OVERVIEW PLOTTING FUNCTIONS 

&CMD16 = 22806 2 
&K26 = 2 

&DESCRIP26 = PLOT 1 

&CMD26 = 22845 2 
ScK 36 =3 

S=DESCRIP36 = PLOT 2 

&CMD36 = 22882 2 



&DESCRIP35 



PRINTING YOUR RESULTS 
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&K46 = 4 

&DESCRIP46 = PLOT 3 

&CMD46 = 22919 2 

&KSUM6 =12345FGHIJKLMNOPQRST 
&K56 = 5 

&DESCRIP56 = PLOT 4 

&CMD56 = 22956 2 

5cl = title 

&TITLE6 = THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND SAVE 
4 PREDEFINED PLOTS. 

&LVL = 1 

&PAGE = 1 



10000 bytes allocated 2641 bytes free 
******************************************************** 

* Remove the previous data ONLY if further changes will* 

* not be made * 

icic'^iiciciic'kiciic'kic'k'k'k'k'k'k'k'k'k'k'k'k'k'ic'k'ic'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kif'k'k'k'k'k'k'k'k'k'k'k'kiii 

-topi %A = 1 

color \1F 

ram 

els 

begtype 



L MENU \1F 

\1A FOR THE DYNAMICA MODEL OF SOFTWARE PROJECT 

MANAGEMENT. \1F 



MENU 



RESULTS 



GRAPHS 



\1D 1 \1F INTRODUCTION TO THE MODEL 



\1D 2 \1F HELP FACILITIES 



\1D 3 \1F VARIABLE MANIPULATION 



\1D 4 \1F RUN SIMULATIONS 



\1D 5 \1F TO STORE AND PRINT 



\1D 6 \1F VIEW RESULTS AND PRINT 
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\1D 7 



\1F EXIT TO DOS 



Choose an option: (ESC exits menu):; 

end 

-Istkeyl inkey %0 | if %0 # = 1 type %0 , 

if %0 = keyOlb return 
goto 

-2ndkeyl inkey %1 I if 



if 

if 

if 

if 

if 



%1 

%1 



goto 



= keyOlb 
= key020 
= keyOOd 
= keyOOS 
= keyl4b 



%1 # = 1 type %1; 
return 
goto -$%0$1 
goto -$%0$1 
goto -topi 
goto -topi 



**** introduction to THE MODEL MENU **** 
call -top2 

bat /p /s goto -topi 



_2~i **** help FACILITIES **** 
call -top3 

bat /p /s goto -topi 

_3-l **** VARIABLE MANIPULATION **** 
BAT CLS 

BAT SHELL BAT /R VARIABL.BAT 
bat /p /s goto -topi 



_4'«1 **** RUN SIMULATIONS **** 
BAT CLS 

BAT SHELL BAT /R RUNSIM.BAT 
bat /p /s goto -topi 



**** TO STORE AND PRINT RESULTS **** 
call -top5 

bat /p /s goto -topi 



_g-X **** VIEW RESULTS AND PRINT GRAPHS **** 
BAT CLS 

BAT SHELL BAT /R VIEWSIM.BAT 
bat /p /s goto -topi 



-y-l **** exit to DOS **** 
BAT CLS 
BAT EXIT 

bat /p /s goto -topi 



-%0'-l 

-$% 0$1 

-%0%11 beep goto -topi 
-top2 %A = 2 
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color \1F 

ram 

els 

begtype 

0 THE MODEL MENU \1F 

\1A THE FOLLOWING MENU PROVIDES INRTODUCTORY INFORMATION 
TO NEW USERS. \1F 



\1D 1 \1F PURPOSE OF THE MODEL MENU 



REQUIREMENTS 



\1D 2 \1F HARDWARE/SOFTWARE 



MENU 



\1D 3 \1F SUGGESTIONS FOR USING THE 



Choose an option: 
end 

-lstkey2 inkey %0 I 
if %0 = keyO 
goto -%0''2 
-2ndkey2 inkey %1 I 
if %1 = keyO 
if %1 = keyO 
if %1 = keyO 
if %1 = keyO 
if %1 = keyl 
goto -%0%12 



(ESC exits menu):; 



if 


%0 # = 


1 type 


%0; 


lb 


return 






if 


%1 # = 


1 type 


%1; 


lb 


return 






20 


go to - 


$%0$2 




Od 


goto - 


$%0$2 




08 


go to - 


top2 




4b 


goto - 


top2 





- 1-2 **** PURPOSE OF THE MODEL MENU **** 
BAT CLS 

BAT SHELL BAT /R PURPOSE.BAT 
bat /p /s goto -top2 



- 2-2 **** HARDWARE/SOFTWARE REQUIREMENTS **** 
BAT CLS 

BAT SHELL BAT /R HARDWAR.BAT 
bat /p /s goto -top2 



- 2-2 **** SUGGESTIONS FOR USING THE MENU **** 
BAT CLS 

BAT SHELL BAT /R SUGGEST.BAT 
bat /p /s goto -top2 



-% 0''2 

-$% 0$2 

-%0%12 beep goto -top2 
-top3 %A = 3 
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color \1F 

ram 

els 

begtype 



CILITIES \1F 

\1A INTRODUCTION TO DYNAMICA AND PROFESSIONAL DYNAMO 
HELP FACILITIES. \1F 



FACILITIES 



\1D 1 \1F OVERVIEW OF HELP 



INFORMATION 



\1D 2 \1F ONLINE MODEL HELP 



\1D 3 \1F PROFESSIONAL DYNAMO HELP 



Choose an option: (ESC exits menu) 

end 

-IstkeyS inkey %0 I if %0 # = 1 type 
if %0 = keyOlb return 



goto -%0"3 

-2ndkey3 inkey %1 1 if 
if %1 = keyOlb 
if %1 = key020 
if %1 = keyOOd 
if %1 = keyOOS 
if %1 = keyl4b 
goto -%0%13 



%1 # = 1 type 
return 
goto -$%0$3 
goto -$%0$3 
goto -top3 
goto -top3 



% 0 ; 



% 1 ; 



_l-3 **** OVERVIEW OF HELP FACILITIES **** 
BAT CLS 

BAT SHELL BAT /R OVER.BAT 
bat /p /s goto -top3 

-2^3 **** ONLINE MODEL HELP INFORMATION **** 
BAT CLS 

BAT SHELL BAT /R HELP.BAT 
bat /p /s goto -top3 

_3-3 **** professional DYNAMO HELP **** 
call -top4 

bat /p /s goto -top3 



-%0'-3 

-$%0$3 

-%0%13 beep goto -top3 
-top4 %A = 4 

color \1F 
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ram 

els 

begtype 

L DYNAMO HELP \1F 

\1A THE FOLLOWING MENU PROVIDES ACCESS TO PD HELP 

FACILITIES. \1F 



\1D 1 \1F OVERVIEW OF PD HELP 



\1D 2 \1F DYNEX HELP 



\1D 3 \1F EDITOR HELP 



\1D 4 \1F SIMULATION HELP 



\1D 5 \1F TOOLS HELP 



\1D 6 \1F TRANSLATOR HELP 



UD 7 \1F UTILITIES HELP 



UD 8 \1F VIEW HELP 



Choose an option: (ESC exits menu):; 

end 

-IstkeyA inkey %0 I if %0 # = 1 type %0 ; 
if %0 = keyOlb return 



goto 

-2ndkey4 inkey %1 I if 
if %1 = keyOlb 
if HI = key020 
if HI = keyOOd 
if %1 = keyOOS 
if HI = keyl4b 
goto -%0%14 



%1 # = 1 type 
return 
goto -$%0$4 
goto -$%0$4 
goto -top4 
goto -top4 



% 1 ; 
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_1''4 **** OVERVIEW OF PD HELP **** 

BAT CLS 
L PD. HP 

bat /p /s goto -top4 

_2-4 **** DYNEX help **** 

BAT CLS 
L DYNEX. HP 

bat /p /s goto -top4 

_3-4 **** EDITOR HELP **** 

BAT CLS 
L EDTR.HP 

bat /p /s goto -top4 

_ 4~4 **** SIMULATION HELP **** 

BAT CLS 
L SMLT.HP 

bat /p /s goto -top4 

_5-4 **** tools help **** 

BAT CLS 
L TOOLS. HP 

bat /p /s goto -top4 

_6-4 **** translator HELP **** 

BAT CLS 
L TRNS.HP 

bat /p /s goto -top4 

_7-4 **** UTILITIES HELP **** 

BAT CLS 
L UTILS. HP 

bat /p /s goto -top4 

_8~4 **** VIEW HELP **** 

BAT CLS 
L VIEW. HP 

bat /p /s goto -top4 

-%0-4 

-$%0$4 

-%0%14 beep goto -top4 
-top5 %A = 5 

color \1F 

ram 

els 

begtype 

PRINT RESULTS \ IF 

\1A THIS MENU ALLOWS THE USER TO STORE AND PRINT 

SIMULATION RESULTS. \1F 
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\1D 1 



\1F STORING STATISTICS 



\1D 2 \1F PLOTTING RESULTS 



UD 3 \1F PRINTING YOUR RESULTS 



Choose an option: (ESC exits menu):; 

end 

-IstkeyS inkey %0 | if %0 # = 1 type %0; 

if %0 = keyOlb return 
goto -%0''5 

-2ndkey5 inkey %1 I if %1 # = 1 type %1; 
if %1 = keyOlb return 
if %1 = key020 goto -$%0$5 
if %1 = keyOOd goto -$%0$5 
if %1 = keyOOS goto -top5 
if %1 = keyl4b goto -top5 
goto -%0%15 

**** STORING STATISTICS **** 

BAT CLS 

BAT SHELL BAT /R SIMULAT.BAT 
bat /p /s goto -top5 

_2~5 **** PLOTTING RESULTS **** 
call -top6 

bat /p Is goto -top5 

_3~5 **** PRINTING YOUR RESULTS **** 

BAT CLS 

BAT SHELL BAT /R PRINT.BAT 
bat /p /s goto -top5 



-%0~5 

-$%0$5 

-%0%15 beep goto -top5 
-top6 %A = 6 

color \1F 

ram 

els 

begtype 

G RESULTS \1F 

\1A THE FOLLOWING MENU ALLOWS THE USER TO VIEW AND SAVE 4 
PREDEFINED PLOTS. \1F 
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\1D 

FUNCTIONS 

\1D 
\1D 
\1D 
N LD 



1 \1F OVERVIEW PLOTTING 



2 \1F PLOT 1 



3 \1F PLOT 2 



4 \1F PLOT 3 



5 \1F PLOT 4 



Choose an option: (ESC exits menu) 

end 

-IstkeyG inkey %0 I if %0 # = 1 type 
if %0 = keyOlb return 



goto -%0''6 

-2ndkey6 inkey %1 I if 
if %1 = keyOlb 
if %1 = key020 
if %1 = keyOOd 
if %1 = keyOOS 
if %1 = keyl4b 
goto -%0%16 



%1 # = 1 type 
return 
goto -$%0$6 
goto -$%0$6 
goto -tops 
goto -top6 



% 0 ; 



% 1 ; 



-l-g **** OVERVIEW PLOTTING FUNCTIONS **** 
BAT CLS 

BAT SHELL BAT /R OVERVIE.BAT 
bat /p /s goto -top6 



-2''6 **** PLOT 1 **** 

BAT CLS 

BAT SHELL BAT /R PLOTl.BAT 
bat /p /s goto -top6 



_3~6 **** plot 2 **** 

BAT CLS 

BAT SHELL BAT /R PLOT2.BAT 
bat /p /s goto -top6 



**** PLOT 3 **** 

BAT CLS 

BAT SHELL BAT /R PLOT3.BAT 
bat /p /s goto -top6 
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-5''6 **** PLOT 4 **** 

BAT CLS 

BAT SHELL BAT /R PLOT4.BAT 
bat /p /s goto -top6 



-% 0'-6 

-$% 0$6 

-%0%16 beep goto -top6 
-on. error- 

if %R > 82 if %R < 90 type !! Floating Point Error !! Igoto 
-Calc . 

Cls beep type Unexpected batch file error %R in line %L 
I exit 
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APPENDIX C 



DYNEX MODEL INTERFACE PROGRAM LISTING 



display clear 

iKicicicifiiicitifificieifificicififititic'k'k'k'k'k'k'k'k'k'k'kic'kicic'k'k’kic'k'k'k'kic'k'k'k'k'k'k'k'k'k'k'kie'k'k'k 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 

March 1988 

************************************************************ 

Press ENTER for a brief introduction to Model and 
Variable Manipulation. 

It is suggested reading for all new users of Dynamica. 

Experienced users will most likely want to skip directly 
to Model and Variable Manipual tion . To do so type (n)o 
followed by enter. 



Press Enter or (n)o followed by Enter to Continue 



dendq 
choice 1 

display clear 

WELCOME TO PROFESSIONAL DYNAMO AND THE DYNAMICA MODEL OF 
SOFTWARE PROJECT MANAGEMENT page 1 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★■AT 

INTRODUCTION 

Professional Dynamo is a high level model simulation 
language that has been used to create THE DYNAMICA MODEL OF 
SOFTWARE MANAGEMENT. You need to have no knowledge of how 
Professional Dynamo works to use the model. 

THE DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT, here 
after simply Refered to as DYNAMICA, is a sophisticated 
simualtion model designed to provide assistance in 
understanding and estimating the numerous and complex 
variables involved in a large software development project. 



Press Enter to Continue 

dendq 
choice 1 
cend 1/1 
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display clear 

*****************»K*******iir*******************)l(*********** 

Introduction paige 2 * 

i<i<i<i<i<i<i<'ki('ki<i<i(i<i<'k'ki<-ki<'ki<'k-k'k'k'k'k'k'k'k'ki<-k'k'k'k'k-ki<i<i<-ki<i<'k'ki(i(i('k'ki('k'k'ki( 



To speed you on your way, a menu system has been 
developed to interface with the model which is written in 
PROFESSIONAL DYNAMO. This menu allows the the user to 
customize the model to fit a particular software project by 
providing access to 18 different variables or table values, 
from three major areas of interest to the software project 
manager: Estimated Project Size, Organizational Environment 
and Policy Variables. A fourth area provides the 
user access to important model controls, the maxlength of 
project the save period for data. 

Press Enter to Continue 

dendq 
choice 1 
cend 1/1 



display clear 



Introduction 



page 3 

******************************************************** 



When addressing a particular variable, the user may 
chose any value or use a previously defined value. Changes 
to variables from your last simulation are automatically 
stored with your simulation results if you chose to store 
your results. 

Your first step after you become familiar with the 
mechanics of uhe model will be to adjust all the pertinent 
variables to customize the model to represent any specfic 
software project you might have in mind. Otherwise, you may 
use the model " as is ”, to conduct your experimentation 
in the relationships of the variables. 



Press any Key to Continue 

dendq 
choice 1 
cend 1/1 



display clear 
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★★★*★**★**★*★***★**★*****★★**★**★***★*★*★★**★★*★***★★**★★★** 



Introduction 



page 4 * 



************************************************************ 



The DYNAMICA MODEL OF SOFTWARE PROJECT MANAGEMENT 
has the potential for extensive online help facilities. 
Currently, only one aspect of the online help facility is 
employed, that being HELP on HELP. This has been done to 
demonstrate the available capability. To view the HELP on 
HELP, type (h)elp followed by a space and (h)elp again 
followed by striking the enter/return key. 



Press Enter to Continue 

dendq 
choice 1 

cend 1/1 
cend 1/1 



display clear 

* ********************************************************** 
* VARIABLE MANIPULATION page 5 * 



The following 18 model varaibles 
adjustable via the menu. 

They are grouped in 4 categories 



of Dynamica are 
for easy access. 



I . 
II . 



Ill 



ESTIMATED ACTUAL PROJECT SIZE 

1. RJBDSI Real Job Size in DSI 

VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 

A. Productivity 

2. DSIPTK Delivered Source 

Instruction Per Task 

B. Quality 

3. TNERPK . . Error Rate Per 1000 Delivered Source 

Instruction 

C. Staffing Variables 



4. HIREDY Hiring Delay 

5. ASIMDY Assimilation Delay 

6. AVEMPT Average Employment 

POLICY VARIABLES 

A. Estimation 

7. UNDEST Task Underestimation Factor 

8. TOTMDl Total Mandays 

9. TDEVl Time to Develope 
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Press Enter To See the Remaining Variables 

dendq 
choice 1 
cend 1/1 

display clear 

MODEL AND VARIABLE MANIPULATION 

'k'k'k'k-k'k-k'k'k-k'k'k'k'k'k^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k-k'k-k 

B. Resource Allocation 

10. DEVPRT % of Effort Assumed Needed 

For Development 

11. TPFMQA . Fraction of Manpower Devoted to 
Quality Assurance 

12. INDUST Initial 

Understaffing Factor 

13. WCWFl Willingness to Change 

the Workforce 

C. Staffing 

14. TRPHNR . . . % of Experienced Employee Effort 

to Train a New Employee 

15. AMPPS . Average Daily Manpower / Staff 
Expended On Project 

IV. MODEL CONTROL 

16. MAXLEN Max Length Of Project 

17. SAVPER Save Period For Data 



Press Enter to See Variable Definitions or to Manipulate 
Variable Values, 
dendq 
choice 1 
cend 1/1 

display clear 

MODEL AND VARIABLE DEFINITION AND MANIPULATION page 7 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'kiK'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

Select one or more of the following eight topic 
areas. You may chose to first look at a brief explanation of 
the variables or go directly to variable manipulation. 

I. MODEL VARIABLE DEFINITIONS 

1. ESTIMATED ACTUAL PROJECT SIZE DEFINITION 

2. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT DEFINED 

3. POLICY VARIABLES DEFINED 



'k'k'k'k'k'k'k'k'k'k'k'k 

page 6 

*ilt********** 
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4. 



MODEL CONTROL VARIABLES DEFINED 



II. MANIPULATION OF MODEL VARIABLES 

5. ESTIMATED ACTUAL PROJECT SIZE 

6. VARIABLES CHARACTERISTIC OF THE ORGANIZATIONAL 
ENVIRONMENT 

7. POLICY VARIABLES 

8. MODEL CONTROL VARIABLES 

Enter the number (s) of your selected choices. 
Seperate each choice by a space or a comma, 
dendq 
choices 8 



display clear 

'k'k'k'kif'kiie'k'k'k'k'kie'k'k'^c'^'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'fc'k'k'k'k'k'k'k 

ESTIMATED ACTUAL PROJECT SIZE DEFINITION page 8 

REAL JOB SIZE IN DSI RJBDSI 



The real size of the software project in delivered 
source instructions (DSI) with comments. The following 
definitions are from Boehm, 1981. 

Delivered. This term is generally meant to exclude 
nondelivered support software such as test drivers. However, 
if these are developed with the same care as delivered 
software, with their own reviews, test plans, documentation, 
etc., then they should be counted. 

Source Instructions. This term includes all program 
instructions created by project personnel and processed into 
machine code by some combination of preprocessors, compilers, 
and assemblers. It excludes comment cards and unmodified 
utility software. It includes job control language, 
format statements and data declarations. Instructions are 
defined as lines of code or card images. Thus, a line 
containing two or more source statements counts as one 
instruction; a five-line data declaration counts as five 
instructions . 



dendq 
choice 1 
cend 1/1 
cend 1/8 



Press Enter to Continue 



display clear 
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VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 

DEFINITION page 9 

****************************************************** 

DELIVERED SOURCE INSTRUCTION PER TASK DSIPTK 

This parameter is set to the value of the nominal 
potential productivity in the organizational environment 
being modeled. For example, if the nominal potential 
productivity is 50 DSI/Man-Day then DSIPTK would be set to 
50 . 



ERROR RATE PER 1000 DELIVERED SOURCE 
INSTRUCTIONS (KDSI) ...... TNERPK 

TNERPK is the number of errors committed on the average, 
per 1000 DSI, as the software project is being developed. It 
is not a single number but rather a table function. This 
allows the user to set different error rates at different 
stages of the project's lifecycle. 

Press Enter to Continue 

dendq 



choice 1 
cend 1/1 

display clear 

•k'kiciciticicicicicicicicieiciciciticicic'kit'kicic'kicicific'kic'k'kicicit'kic'kicic'kicicic'k'k'k'kicic'k'k'k'kic'k 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
DEFINITION page 10 



HIRING DELAY HIREDY 

HIREDY is the average delay time, in work days, incurred 
in adding new staff members to the project. 



ASSIMILATION DELAY . , ASIMDY 

ASIMDY is the average time needed to assimilate new 
hirees into the project, measured in workdays. It is the 
time required for orientation, institutionalization and 
training . 

Press Enter to Continue 

dendq 



choice 1 
cend 1/1 
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display clear 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
DEFINITION page 11 

AVERAGE EMPLOYMENT AVEMPT 

AVEMPT is the average employment time of project team 
members, measured in working days. It is indirectly 
proportional with TURNOVER. For example, the smaller the 
AVEMPT the larger the turnover rate, and conversely, the 
smaller the turnover rate the higher the AVEMPT. 



Press Enter to Continue 

dendq 
choice 1 
cend 1/1 

cend 2/8 
display clear 

POLICY VARIABLES DEFINITIONS page 12 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 

TASK UNDER ESTIMATION FACTOR UNDEST 

Undersizing is a large problem in project management. 
This variable allows the to experiment with different values 
of underestimates. Thus to simulate a situation where the 
project size is initially underestimated by 25 %, this 
variable would be set to 0.25. 

TOTAL MAN DAYS TOTMDl 

TOTMDl is the man-day estimate produced at the start of 
the project, for design, coding and system testing of the 
pro j ect . 

TIME TO DEVELOP TDEVl 

TDEVl represents the estimated time, measured in work 
days, for the design, coding and testing stages of the 
project, produced at the start of the project. For example, 
if the initial project duration estimate was 16 months, 

TDEVl would be equal to (16 x 20) or 320 working days. 

Press Enter to .Continue 



dendq 
choice 1 
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cend 1/1 



display clear 

★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 
POLICY VARIABLES DEFINITIONS page 13 

% OF EFFORT ASSUMED NEEDED FOR DEVELOPMENT . . . DEVPRT 

This variable is used to allocate the projected total 
budget, measured in Man-Days, for the development (which 
includes design and coding) and testing phases. For example, 
if it is decided that 80 % of the total Man-Days would be 
allocated to development and 20 % to testing, then DEVPRT 
would be set to 0.80. 

FRACTION OF MANPOWER DEVOTED TO QUALITY 

ASSURANCE TPFMQA 

TPFMQA is the percent of development effort allocated in 
the project's plan for QA activities during the design and 
coding stages. It is not a single number but rather a table 
function that allows the user to change the number of 
Man-Days allocated to QA at different stages in the project 
lifecycle. A value of 0.20 at some point in the project 
would indicate that at this point, 20 % of the Man-Day budget 
is allocated to QA . 

Press Enter to Continue 

dendq 
choice 1 
cend 1/1 

display clear 

********************************************************* 

POLICY VARIABLE DEFINITIONS page 14 

********************************************************* 

INITIAL UNDERSTAFFING FACTOR INDUST 



The project's average staffing level is equal to the 
project's total number od Man-Days divided by the project's 
scheduled duration. Typically, the project will start with a 
small core team which grows in size. This variable specifies 
the size of the starting group. Thus a value of 0.5 
indicates that the startup team is half 
average staff size. 



the size of the 



Press Enter To Continue 



dendq 
choice 1 
cend 1/1 



display clear 
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POLICY VARIABLES DEFINITIONS page 15 

WILLINGNESS TO CHANGE THE WORKFORCE WCWFl 

On deciding upon a "Workforce" level desired, project 
managers typically consider a number of factors. One 
important factor is the project's scheduled completion date. 



As part of the planning function, management determines the 
workforce level that it believes is necessary to complete the 
project on schedule. In addition to this factor, 
consideration is also given to the stability of the 
workforce. Thus, before adding new project members, 
management tries to contemplate the project employment for 
new members. Different organizations weigh this factor 
differently. In general, the relative weighing between th 
desire for workforce stability on one hand and the desire to 
complete the project on time, on the other, is not static, 
but changes dynamically throughout the lifecycle of the 
project. For example, toward the end of the project there is 
typically considerable reluctance to bring in new people, 
even if the project is behind schedule. It would take 
too much time and effort ( relative to the time and effort 
that are remaining) to acquaint new people with the mechanics 
of the project, integrate them into the project team and 
train them in the necessary technical areas. 

Press Enter for More Information of WCWFl 



dendq 
choice 1 
cend 1/1 

display clear 

WCWFl DEFINITION CONTINUE page 16 

These managerial considerations are operational in the 
model as follows; 

WORKFORCE LEVEL NEEDED = (INDICATED WORKFORCE LEVEL) * (WCWF) 
+ (CURRENT WORKFORCE) * (1-WCWF) 

The Weighting Factor (WCWF) is termed Willingness to 
Change the Workforce. 

In the early stages of the project when "Time Remaining" 
is generally much larger than the sum of "Hiring Delay" and 
the "Average Assimilation Delay" WCWF would be equal to 1. 
When WCWF is = 1, the "Workforce Level Needed" in the above 
equation would simply be equal to the "Indicated Workforce 
Level," i.e., management would be adjusting its workforce 
size to the level it feels is needed to finish on schedule. 
The "Indicated Workforce Level" can be determined by dividing 
the amount of effort that management percieves is still 
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remaining (in Man-Days) by the time remaining to complete the 
project in days. 

When the "Time Remaining" decreases, ASSIMILATION DELAY 
(ASIMDY) could be set to equal exactly 0. The "Workforce 
Level Needed" in the equation would thus be equal to the 
"Current Workforce" i.e., management attempts to maintain 
the projects workforce at its current level, and make 
adjustments to the schedule instead. 

Press Enter to Continue 

dendq 
choice 1 
cend 1/1 

display clear 

'kiK'k'k'kif'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k’k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k 

POLICY VARIABLE DEFINITIONS page 17 

itiificic'kic'k'k'k'k'k'kit'k-kiif'kic'k'k'k'k'k'k'k'k-k'k'k'k'k'k'k-k-k'k-k'k-k'k'k'k'k-k'k-kit'k'k'k'k'k-k-k'k'k’k 

TRAINERS PER NEW EMPLOYEE TRPHNR 

In most organizations, training of new employees is 
carried out by the more experienced employees. This variable 
defines the fraction of an experienced staff member's time 
that is devoted to train new hirees. For example, a value of 
0.2 indicates that on the average each new employee 
consumes 20 % of an experienced employee's time for the 
duration of the assimilation delay. 



AVERAGE DAILY MANPOWER PER STAFF EXPENDED ON 



PROJECT 

Project members are 



ADMPPS 

often only assigned part-time to a 
project. ADMPPS defines the % of time that the team members 
devote, on an average to the particular project being 
simulated. For example, if staff members tend to divide 
their time equally between two projects, i.e., half of their 
time is spent on project A and the other half is spent on 
project B, then ADMPPS would be = 0.5. 



dendq 
choice 1 
cend 1/1 
cend 3/5 



Press Enter to Continue 



display clear 

MODEL CONTROL VARIABLE DEFINITIONS page 18 






MAX LENGTH OF PROJECT 



MAXLEN 



100 



This model control variable is useful in controlling the 
simulations. It precludes the model from continuing a 
simulation beyond a predetermined length, e.g., 1000 days. 



SAVE PERIOD FOR DATA SAVPER 

This model control varaible allows the user to adjust 
the models save period for data for later viewing. For 
example, if the user sets the SAVPER = 1, the model will save 
all variable values on a daily basis, this data would be 
available for the usedr to examine and plot at the end of a 
simulation. A SAVPER of 10, saves values every 10 days. This 
provides the user with a trade off between the time required 
for a simulation and the level of detail of the results. 



dendq 
choice 1 
cend 1/1 
cend 4/8 



Press Enter to Continue 



display clear 

i<i<'k'kic'kic'k'ki(i<ic'ki<'k'k'k'k'kit'ki<'k'kic'ki<ici>ci<i<'k'kicic'ki<'kici<'k'kicic'k:k'kici<i:'ki('k'k'k'ki( 

ESTIMATED ACTUAL PROJECT SIZE VARIABLE MANIPULATION 

page 19 * 

REAL JOB SIZE IN DELIVERED SOURCE 
INSTRUCTIONS RJBDSI 

Enter a new value for REAL JOB SIZE IN DELIVERED SOURCE 
INSTRUCTIONS or press enter to use the preset value. The 
preset value is written using a form of scientific notation 
where e3 represents x 10 to the third power. You do not have 
to enter a value in that format but be aware that the model 
will represent numbers in that format, 
dendq 

cq r jbdsi=24 . 4e3 



cend 5/8 



display clear 
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VARIABLES CKARACTERI STIC OF ORGANIZATIONAL ENVIRONMENT 

MANIPULATION page 20 

*********************************************************** 



Enter a new value for DELIVERED SOURCE INSTRUCTIONS PER 
TASK or press enter to use the preset value, 
dendq 

cq dsiptk=40.0 



display clear 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
MANIPULATION page 21 



Enter a new value for ERROR RATE PER 1000 DELIVERED 
SOURCE INSTRUCTIONS or press enter to use the preset value. 

1 2 3 4 5 6 

dendq 

cq tnerpk=24, 22 .9,20.75,15.25,13.1,12 



display clear 

******************************************************* 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 

MANIPULATION page 22 

******************************************************* 



Enter a new value for HIRING DELAY or press enter to use 
the preset value. 

dendq 

cq hiredy=30. 



display clear 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 

MANIPULATION page 23 

******************************************************** 
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Enter a new value for ASSIMILATION DELAY or press enter 
to use the preset value, 
dendq 

cq asimdy=21.0 



display clear 

VARIABLES CHARACTERISTIC OF ORGANIZATIONAL ENVIRONMENT 
MANIPULATION page 24 

'k'k'k'k'k'k'k'k'k'kieic'k'kie'kit'kie'k'kic'kic'k'kicic'kic'kic'k'k'k'k'k'k'kic'k'k'k'k'kic'k'k'k'k'k'k-k'kific'kie 



Enter a new value for AVERAGE EMPLOYMENT or press enter 
to use the preset value. 

dendq 

cq avempt=1000 



cend 6/8 



display clear 

********************************************************* 

POLICY VARIABLE MANIPULATION page 25 

********************************************************* 

For assigning values to TOTAL MANDAYS and TIME TO 
DEVELOPE the user may either: 

1. Calculate the two values external to the model 
and input them directly at the prompt below. 

OR 

2. Allow the model to calculate the two values 
internally utilizing COCMOC by inputing 0 for each of the 2 
variables at the COCMO prompt. 



TOTMDl 

TDEVl 

dend 

cq totmdl=llll 
cq tdevl=320 
display 
COCOMO PROMPT: 

Enter 1 at the next two prompts to allow COCOMO to compute 
TOTMDl AND TDEVl. 

OR enter 0 to use your own values input above. 
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dend 

cq scswch=0 
cq mdswch=0 

pjbdsi=r jbdsi* ( 1-undest) 
display 

T0TMD1=( (2.4*EXP(1.05*LOGN(pjbdsi/1000) ) )*19. 
dendq 

display 

TDEV1=( ( 19*2. 5*EXP(0 . 38 *LOGN ( to tmd/ 19 ) ) . 
dendq 

display 

#TDEV1 



Press Enter to Continue 

dendq 

choice 1 
cend 1/1 

display clear 

POLICY VARIABLES MANIPULATION page 26 

Enter a new value for TASK UNDER ESTIMATION FACTOR or 
press enter to use the preset value. 

dendq 

cq undest = . 35 



display clear 

POLICY VARIABLES MANIPULATION page 27 

******************************************************* 

Enter a new value for % OF EFFORT ASSUMED NEEDED FOR 
DEVELOPMENT or press enter to use the preset value. 

dendq 

cq devprt=.5 
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display clear 

POLICY VARIABLES MANIPULATION page 28 

ieici<i<icicieiK'k'k'k'k'k'k'k'k'k'kic'k'k'k'k'kic'k'k'k'k'k'k'k'ki('k'k'k'ki('kic'k'ki('k'k'k'k'k'kie'k'k'k'k 



Enter a new value for FRACTION OF MANPOWER DEVOTED TO 
QUALITY ASSURACE or press enter to use the preset value. 

1 23 456789 10 11 

dendq 

dq tpfmqa=. 325, .29, .275, .255, .25, .275, .325, .375, .4, .4,0.0 



display clear 

i<ici<i<ici(i<i<icici<i('k'k‘k‘k'k‘k‘k‘k'k‘k‘k-k‘k-k-k'k‘k'k-k'k-kici(-k-k‘k-k'k'k‘k'k'k'ki('k-k'k'k-k'k-k'k-k'k'k 

POLICY VARIABLES MANIPULATION page 29 



Enter a new value for INITIAL UNDERSTAFFING FACTOR or 
press enter to use the preset value. 

dendq 

cq inudst=.4 



display clear 

iciciciciciiiciciciiicicicicicicieicicicicieicicicicieicicicificificicifificifiticiKiK'k'kiK'kic'k'k’kic-k'k-k-k 

POLICY VARIABLES MANIPULATION page 30 



Enter a new value for WILLINGNESS TO CHANGE THE WORKFORCE 
or press enter to use the preset value. 

1 2 3 4 5 6 7 8 9 10 11 12 13 14 

dendq 

dq 

twcwfl=0 . 0,0 . 0, .1,. 4,. 85, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0 
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display clear 

ic'k'kicifitic'kic'k'k'k'k'k'k'k'k'kic'k'k'k'k'k'kic'kilic'k'k'k'k'k'k'kic'kit'k'kic'k'k'k'kitic'k'k'k'kic'k'k'k'k'kic 

POLICY VARIABLES MANIPULATION page 31 

*********************************************************** 



Enter a new value for % OF EXPERIENCED EMPLOYEE EFFORT TO 
TRAIN A NEW EMPLOYEE or press enter to use the preset value. 

dendq 

cq trpnhr= . 25 



display clear 

yt***********-^****************************************** 

POLICY VARIABLES MANIPULATION page 32 



Enter a new value for AVERAGE DAILY MANPOWER PER STAFF 
EXPENDED ON PROJECT TO TRAIN A NEW EMPLOYEE or press enter 
to use the preset value, 
dendq 

cq adrapps=.5 
cend 7/8 



display clear 

'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'k'ki^'k'k'kic'kif'k'k'k'kitic'k'k'k'k'k'k'kic'k'k'k'k'k'k'k'k'k'k'kit'k 

MODEL CONTROL VARIABLE MANIPULATIONS page 33 

******************************************************* 



Enter a new 
enter to use the 



value for MAX 
preset value . 



LENGTH OF PROJECT or 



press 



dendq 

cq maxlen=1000 
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display clear 

MODEL CONTROL VARIABLE MANIPULATIONS page 34 

********************************************************** 



Enter a new value for SAVE PERIOD FOR DATA or press 
enter to use the preset value. 

dendq 

cq savper=10 



cend 8/8 



quit 
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